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Don’t judge us by our cover - 
This issue we look at Clipper. 


Where do we go from five-oh? 
The Clipper language grows up. 


How to persist TBrowse objects. 

P| ee A 
There are four new regular columns, 
To please C lovers and C haters. 


| SEE 


Five Programmer’s Editors compared. 
And, oh yes, there’s Microsoft's Cuay 
An exclusive try-out of a Beta called Pete. 


Obj 


Introducing the First 
Complete Education Programme in 


ect-Oriented 


Technology 


f properly implemented the benefits of object 
| beta to software developers can be 
immense, but as an 
emergent technology 
there areas many 
pitfalls as opportuni- 
ties. 

QA has a unique and unified education 
programme in Object-Oriented Technology (OOT) 
which will help you address the issues and 
deliver the benefits. 

The cornerstone of our programme is the 
management-level Strategic Briefing explaining the 
benefits of OOT and how to evaluate, pilot and 
implement projects. An essential to all those who 
will be involved in OOT decision making. 

Alternatively, you may prefer to begin with 
the Primer course, a technical intro- 
duction to OOT and an excellent 


first step toward both 
An integral part of our 


OOT programme is that 


for C++, one of the 


Tick here for details: 


industry's most popular implementation 


languages to achieve your Object-Oriented goals. 


As-a result of our total commitment to OOT 
and the considerable 
expertise we have 
now developed in 
the subject, your 
company may prefer 
to explore and 
develop its commer- 
cial opportunities 


through our consultancy service. 


To obtain full details of 
our carefully structured 
courses and consultancy in 

this new technology, which is set to revolutionise 
the world of software development, simply tele- 
phone Samantha Trinder on 0285 655888 or 


return the coupon. 


Mail to QA Training Ltd, Cecily Hill Castle, Cirencester, Gloucestershire GL7 2EF, UK. 
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| Issue theme: Clipper | 


PRACTICALLY BROWSING WITH CLIPPER 5.01 
James Ormrod inflicts persistent objects on Clipper - 


Here he presents a configurable, saveable TBrowse. 14 
NANTUCKET TOOLS II 

It's a third party add-on from the first party. 

Bob Rimmington delves into a new Clipper function library. 22 
USING PRE-LINK LIBRARIES 

Clipper 5 is bundled with a poor man’s DLL system. 

Aric Rosenbaum explains how to use it. 28 
GREAT EXPECTATIONS 

At last, Microsoft's C/C++ 7.0 is being wheeled out. 

Paul Kemp has been looking at a late Beta copy. 34 
PROGRAMMER’S EDITORS 

Despite modern IDEs, many programmers prefer a separate editor. 

Cliff Saran looks at five modern packages. 46 
SOAPBOX 

The file metaphor is much abused, says John Barber. 2D. 
NEWS 

It’s bye-bye JPI, but hello to an Eiffel for MS-DOS. 4 
LETTERS 

We have a bumper crop of letters this month: 

There’s OS/2, unemployment, PCL and a new competition. 10 
MAYHEM 

Computing has come on so far over the years - or has 54 
LAINE STUMP’S C++ DIARY 

A new column from an American Programmer in Turkey. 

Laine tackles the mixing of classes and Windows DLLs. 56 
IC 

Julian Bucknall manages overlays in Not C but Turbo Pascal. 68 
xXBASE 

Whither Clipper? Right down the OOP, says Chris Sennitt. 

We take a look at what comes after 5.01. 78 
UNIX REGULAR 

Do your programs know too much for their own good? 

A practical approach to configuration from Peter Collinson. 86 
BOOKS 

For a change, we have a Prolog book, reviewed by Gareth Blower. 95 
CUG 

Chairperson Francis Glassborow introduces the C Users Group (UK). 96 
CROSSWORD 

Greetings clue-crackers! Here’s Eric Deeson’s monthly challenge. 96 
STOB 


104 


Stob, whose backing-up policy is sloppy, pays the price. 
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The metaphor 
that went wrong 


Jobn Barber isn’t happy with the way computers: treat files. 


When you use metaphors that are familiar and real-world based, 
users can transfer previous knowledge of their work environment to 
your application interface. You must be careful in choosing a meta- 
phor to make sure the metaphor meets the expectations users have 
because of their real world experience. - Common User Access Ad- 
vanced Interface Design Guide. 

If you were asked to think ofan example where this advice had been 
successfully applied, what would you choose? The first thing which 
comes to my mind is the spray can of a Paint program, The user's real 
world knowledge can be 
transferred in such an obvious 
way that it must be very un- 
usual for anyone to reach for 
the manual. You just pick up 
the can and press the button. 

Unfortunately, not all meta- 
phors are this successful. One 
in particular has suffered from 
inconsistency and poor im- 
plementation. It’s been 
around a lot longer than the 
spray can, and it’s so widely 
used that it’s easy to forget it is 
a metaphor. It is ...FILE. 

1 don’t know who first used 
the word in connection with 
computers, but no doubt they 
were likening computer stor- 
age to the traditional office fil- 
ing cabinet. Yet it seems that 
this potentially helpful meta- 
phor has been obscured by 
later developments. In mod- 
ern GUlapplication programs, 
a standard format File Menu 
has emerged, in conformance 
with CUA guidelines, but even 
here, close scrutiny reveals 
some serious flaws. 

First, the menu seems to be 
designed to keep the user in 
the dark about what is really 
happening. One important 
concept which all users need 
to be aware of is that programs operate on a working copy of data, not 
the original. There is nothing difficult about this. If we were modifying 
a document manually using a pen, it would be sensible to take a 
photocopy and work on that, leaving the original document safely in 
its file until we were happy with the modification. Programs do the 
same. Yet many inexperienced users must be fooled by commands 
such as File Open and File Print, and believe that they are working 
directly on the contents of the file. For them, opening up a file is rather 
like a surgeon opening up a patient. 

This difficulty could be fixed quite easily by some rewording of the 
menu items. A further problem becomes apparent if we take the 
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manual editing analogy a little further. After we have created the 
modified document, we can file it and destroy the original. But some- 
times, we may choose to keep the original also, at least for a while. 
This too is a common event in our real world experience. The equival- 
entaction on the standard file menu, ‘File Save As...’, is hardly intuitive, 
and the user has the inconvenience of having to think up a new name 
for what may be just a new version of the same thing. 

Having multiple versions of documents is such a natural idea in our 
real world experience that it should be an intrinsic part of any computer 
filing system worth its salt. The 
concept of version control is 
just as relevant to the users of 
application programs as to the 
4 software developers who cre- 
ate the programs. 

Why should users, who may 
be non-technical, be expected 
to navigate around a tree-struc- 
‘| tured directory system? Once 

we introduce tree-structured 
filing systems, ‘File’ as a meta- 
phor begins to loose its consist- 
ency. Filing cabinets do not 
grow on trees, 

Obviously, files need to be 
organised in some way. The 
4 important thing is the interface 
which is presented to the user. 
4 Tolocate a file, itshould simply 
be a matter of stating what we 
know about it, eg that it is a 
4 letter and that it was written by 
Jim. The problem with path 
names is that \JIM\LETTERS 
and \LETTERS\JIM do not 
4 meanthe same thing, The orde- 
4 ring of the information which 
occurs in a path name is quite 
@ unnecessary for the user’s pur- 
poses. 

It seems to me that while 
many aspects of software usa- 
A bility have improved dramati- 

cally, those related to files have 
been sadly neglected. Atthe heart of the problem is the implementation 
of a metaphor in a way which doesn’t meet anyone's expectations. 


EXE] 


Jobn Barber was once a respectable mechanical engineer, but his 
reputation was ruined by a brief but passionate affair with a Hewlett 
Packard 9825A in the early 1980's. Since then he has indulged in 
many programming excesses and is now reduced to a life of toil and 
poverty as a freelance programmer. 


“PROGRAM EDITORS_| 


NEW MULTI-EDIT V6 includes new C-like macro 


language, real-time DOS output window, faster virtual | 


memory manager, binary & Unix file editing, XMS 
support, etc, etc. CALL US FOR MORE DETAILS, 
including update pricing. 
NEW MULTI-EDIT LITE must be the bargain editor of 


the year! No macro language, but most other features 
of Standard. ONLY £49. 


OTHER NEW MULTI-EDIT ADD-ONS: MULTI-TAGS 
hypertext source code browser @ £29, EVOLVE for 
dBase or Clipper @ £65, GUIDE.2 context-sensitive 
on-line hypertext reference manual for C++ @ £35 or 


Turbo Pascal 6 @ £20. 
Brief DOS £199 
EC Editor DOS £40 
Epsilon v5 DOS £165 
Kedit v4 DOS £95 
Multi-Edit Lite v6 DOS £49 
Multi-Edit Standard v6 DOS £75 
Multi-Edit Professional v6 DOS £110 
Norton Editor v2 DOS £45 
PVCS Prof Editor DOS £195 
QEdit Advanced DOS £45 
Vedit-Plus v3.5 DOS £120 
Kedit v4 OS2&D0S £105 
Epsilon v5 for OS/2 OS2 £165 
QEdit Advanced for OS/2 Os2 £62 
PVCS Prof Editor OS2 £195 
MIX Editor CPM-Z80 £25 
Vedit-Plus v2.33 CPM-80 £110 


For more information please call us. 


PROGRAMMING TOOLS 


Ada Compilers Algol Compilers 
Assemblers & AWK 

Basic Compilers ic Interpreters 
Basic Utilities ibraries 

C Compilers i 

C Interpreters 

C++ Cobol Compilers 
Comms.Libraries Cross Assemblers 
Database Libs. Debuggers 
Dis-assemblers Editors 

Forth Fortran Compilers 
Fortran Libraries Graphics Libraries 
Icon Linkers/Locaters 
Lisp Logo 

Modula-2 Object Oriented 
Pascal Compilers Pascal Libraries 
Prolog Rexx 

Screen Libraries Smalltalk 


We stock many items for which there is no 
space in these advertisements. 


GREY 


MATTER 


Prices do not include VAT or other local taxes, but 
do include delivery inthe UK and Europe. 

Please check prices at time of order as ads are 
Prepared some weeks before publication. 

This page lists some of our products- call us fora 
Complete price list and details of discount structure. 
ORDER BY PHONE WITH YOUR CREDIT CARD. 


TEL: (0364) 53499 


FAX: (0364) 53071 


Comms 
C Asynch Manager DOS £130 
C Comms Toolkit OOS £89 
Essential Comms DOS £180 
Greenleaf CommLib 3.2 DOS £195 
Silvercomm C Asynch DOS £140 
Database 
Btrieve OS2,Win,DOS £390 
C/Database Toolchest DOS £45 
C-Index/Plus DOS £175 
C-tree Plus DOS £350 
CodeBase 4.5 DOS £215 
cal DOS £270 
D-ISAM DOS £325 
db-VISTA DBMS Object DOS £425 
Essential Btree DOS £110 
Faircom Toolbox Prof v2 DOS £680 
Pro-C & Workbench DOS £799 
SoftFocus Btree/ISAM 0os £80 


Sycero.C Network DOS £895 


MBLERS 


MS MASM PDS v6 
PharLap 386IDOS Ext SDK DOS £330 
PharLap 386IASM/Linkloc DOS £830 
Optasm DOS £125 
Turbo Debugger & Tools DOS = £89 


2500AD Z80 ASM CPM-Z80 = £70 
SLR Z80ASM CPM-280 £40 
SLR Z80ASM-PLUS CPM-Z80 £140 
SLR MAC CPM-Z80 £40 
SLR MAC-PLUS CPM-Z80 £140 
SLR 180 (64180) CPM-Z80 £40 
SLR 180-PLUS (64180) CPM-Z80 £140 


THE C LANGUAGE 


Refer also to the C++ section. 


C COMPILERS 


NEW MICROSOFT C/C++ 7.0 - see C++ section. 
Only £150 for existing Microsoft C owners (if bought 
before 1/2/92 - we need proof of purchase), 


Aztec C86-c DOS £275 


Microsoft C 6.0 OS2&Win&DOS £222 
MS C & Win SDK OS2&Win&DOS £335 
MS QuickC 2.5 DOS £50 
MS QuickC & QuickAsm DOS £83 
MS QuickC for Windows Win £95 
Topspeed C Std DOS £110 
Topspeed C Prof Win&DOS £165 
Watcom C 8.5 OS2&Win&DOS £295 
High C 386 Local 1.7 PL386 = £585 
High C 386 Global 2.3 PL386 £650 
Intel 386 C Code Builder Win&386 £399 
NDP 386 C 386 £545 
Watcom C 8.5/386 Win&386 £495 
Topspeed C Prof OS2 = £165 
Aztec Cll-p CPM-80 £120 
Aztec Cli-c CPM-80 £200 
Hi-Tech C CPM-Z80 £105 
Mix C CPM-Z80 £35 
Aztec C68K MPW C MAC £110 
Aztec C68K/Am-P. AMIGA £120 
Aztec C68K/ST-P ATARI = £120 
Hi-Tech C 68000 ATARI £140 
Prospero C ATARI = £55 


We supply 2500AD, Avocet, Aztec, Lattice, JAR and 
Hi-Tech Cross Compilers hosted on DOS and 
targeted on Z80, 6502, 6801, 68HC11, 6301, 6809, 
7811, 8051, 8096 & 68000/020, Please call for 
information or advice. 


C INTERPRETERS 
New V6 Instant-C is MS C V6 compatible. 
Crterp V3.5 DOS £165 
Instant C V5 DOS CALL 


LOW PRICES 


FOR 
MICROSOFT & BORLAND 
PRODUCTS 


Microsoft Basic PDS 7.1 
Microsoft C/C++ 7.0 
Microsoft © & Windows SDK 
Microsoft Cobol 4.5 
Microsoft Fortran 5.1 
Microsoft Macro Assembler 6.0 
Microsoft Pascal 4.0 
Microsoft QuickBASIC 4.5 
Microsoft QuickC 2.51 
Microsoft QuickC & Assembler 
Microsoft QuickC for Windows 
Microsoft QuickPascal 1.0 
Microsoft Source Profiler 
Microsoft Visual Basic 
Microsoft Windows 3.0 
Microsoft Windows SDK 3.0 
MS Multimedia Dev Kit 
MS MDK & SB Pro Card 
Borland C++ 3.0 
Borland C++ & AFX 3,0 
Borland Corporate Prod Pack 
Turho C++ 
Turbo C++ & Turbo Vision 
‘Turbo C++ for Windows 
Turbo Debugger & Tools 
Turbo Pascal 6.0 
Turbo Pascal Professional 6.0 
Turbo Pascal for Windows 
Paradox 3.5 
Paradox Engine 2.0 

WITH FULL TECHNICAL SUPPORT 
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PROLOG LANGUAG: 


Arity Standard Prolog DOS 


Arity/Prolog Comp. v6 DOS £515 
Arity/Prolog Int. v6 DOS £220 
Fduc.Prolag (ADA) DOS £28 
FS Prolog (ADA) DOS £45 


VMI Prolog (ADA) DOS = £75 


VML Prolog (ADA) DOS £135 
LPA Prolog Prof Prog Ed DOS £300 
Flex Pack Prog Edition DOS £750 
micro-Prolog v3.1 DOS = £69 
PDC Prolog DOS £240 
Prolog++ Pack Prog Ed DOS £375 


Arity/Prolog Comp OS2 £745 


Micro-Prolog v3.1 CPM-86 £69 
Micro-Prolog v3.1 CPM-Z80 £69 


LPA Mac Prolog v3 MAC £450 


Graphics 
Essential Graphics Kernel DOS £130 
Essential Graphics GUI DOS £105 
GFX Graphics DOS = £80 
GraphiC 6.0 DOS £305 
graphics-MENU & Data Entry DOS £180 
GSS GDT OS2,D0S £425 
GX Graphics DOS £120 
GX Effects DOS £120 
GX Text 00S £90 
HALO Professional 2.0 00S £270 
HGraph DOS = £80 
MetaWINDOW DOS £165 
MetaWINDOW/Plus DOS £220 
PCX Programmer's Toolkit DOS £150 
Real-Time Graphics & M/CT DOS £145 
TEGL Windows Toolkit II DOS £70 
Screen 
C Windows Toolkit DOS £59 
C-Scape + Look&Feel OS2&DOS £370 


C-Worthy & cwArchitect DOS £389 
Greenleaf Datawindows DOS £215 


MEWEL Window System DOS £195 
MEWEL Toolbox DOS £165 
Panel Plus II DOS £260 
ProtoView Win £750 


TesSeRact CXL DOS £42 
Vermont Views V3.0 DOS £325 
Vitamin C V4.0 DOS £260 


General & Sundry Libraries 


C Tools Plus/6.0 DOS £105 
CodeRunner DOS £140 


C Utility Library DOS £140 
Greenleaf Functions DOS £125 
Heap Checker i 0dOS = £30 
Heap Expander 3.0 ‘ DOS £85 
Hold Everything DOS £130 
PDK £1, £2, £3 DOS £70 
PowerSTOR DOS = £85 
Resident-C DOS £135 


TesSeRact TSR Dev Sys DOS £42 

Turbo C Tools/2.0 DOS £105 

WKS Library DOS £160 
Math & Scientific 

C/Math Toolchest & Grafix DOS £45 


C Lang Sci Lib ANYC £160 
Huge Virtual Array & NAT DOS £215 
Mathpak 87 DOS = £85 
Science & Eng Tools bOS £79 
Tools 
C/Utilities Toolchest DOS = £45 
C-Clearly DOS = £85 
Clear+ for C DOS £140 
CodeCheck Prof DOS £435 
LALR Pro 4.2 DOS £275 
MKS LEX & YACC DOS £165 
PC-Lint OS28D0S £85 
PCYACC Prof DOS £435 
Source Print OOS = £75 
Tree Diagrammer DOS = £75 


{ DISK COPYING )© 


We can copy files to and from 600 disk formats 
including CP/M, CP/M-86, MS- DOS, PC-DOS, 
APPLE, SIRIUS, BBC, TORCH, APRICOT, HP-150, 
TRSDOS, AMSTRAD, ATARIST, MACINTOSH. 
Our charge is £10.00 + disk + VAT with discounts 
on small quantities and disks are normally 
despatched within 24hrs of receipt. 

For more information call us. 
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o—_cv—e_— News 


| Village People 
Don't forget the Windows Show 1992, 
billed as the UK’s largest ever software 
| event, which is to be staged at Olympia 
| 2, London from 18th-20th February. A 
central attraction will doubtless be the 
| EXE Development Tools Village; the big 
| names in Windows development will all 
| be represented, including Microsoft, 
Borland and Symantech. For more in- 
formation call IT Events Lid on 0256 
381450. 


| Eiffel comes to DOS 
Would you like to be into OOP, but don't 
| fancy something that’s got C in it? Ger- 
| man company SiG GmbH has released 
EiffeV/S, a DOS implementation of V3.0 
of the language. The Eiffel/S compiler 
| outputs C code - so you'll still need a C 
| compiler - and comes with a set of basic 
| class libraries which include classes for 
| 1/0, persistence and data structures. 
Prices start under £400, more info from 
UK distributor Applied Logic Develop- 
ments (081 7801088). 


Blinker outgrows Clipper 
Blink Inc has begun shipping Blinker 
V2.0, the latest release of the popular 
dynamic overlay linker. This now inte- 
grates ad memory swapper, using 
| EMS/XMS memory to enable an execu- 
ting program to generate a DOS shell for 
| running a second program. There is also 
support for several languages including 
Microsoft C, Watcom C, Zortech C++, 
Borland C++, Clipper V5.01 and Assem- 
bler. Blinker costs £189 and is dis- 
tributed in the UK by QBS on 081 
9944842. 


Win £20,000 
| There's a chance to win £20,000 in the 
_ Business Software Challenge '90. To be 
eligible you must be a student at a UK 
| university, polytechnic or other educa- 
| tion establishment during the academic 
| year 1991-1992 (or you were a student 
| in 1990-1991). All you have to do is to 
produce prototype software that ident- 
ifies an area in the business world which 
would benefit from being computerised, 
| Entries may be submitted by individuals 
or by teams of developers. The closing 
date for the competition is 30th April 
1992. For details, write to The Competi- 
tion Secretary, Business Software Chal- 
| lenge '90, 24-28 Bloomsbury Way, 
London WC1A 2PX. You can also tele- 
_ phone on 071 8316262. 


| VB to SQL Server 

| Microsoft bas shipped its Visual Basic 
| Library and SDK for SQL Server. The RRP 
| is £335, Microsoft is on 0734 500741. 
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well), 


not disclosed. 


Clarion buys out JPI 


Clarion Software and UK-based Jensen & Partners International (JPI) have an- 
nounced an intent to merge the two companies. The merger will be accomplished by 
issuing Clarion stock to JPI stockholders. Clarion is an American company, based in 
Florida, which develops 4GL database application development tools for DOS, includ- 
ing Clarion Professional Developer and Clarion Report Writer. JPI is practically the last 
bastion of British-based mainstream compiler development. The company develops 
the TopSpeed family of languages comprising Pascal, Modula-2, C and C++ optimising 
compilers that share a common code generator and IDE. 

JPI has been collaborating with Clarion for the last two years to include its com- 
piler/link technology into V3.0 of Clarion’s Professional Developer 4GL (due to ship 
in Q1 '92), The takeover comes as no surprise to industry-watchers who have recently 
speculated that JPI was spreading itself too thinly with so many compilers to support 
and maintain (at one time the company was planning to develop an Ada compiler as 


JPI was founded in 1987 by Niels Jensen, a co-founder of Borland International, and 
five other former Borland developers, The development staff of JPI will remain in 
London and will be known as the TopSpeed Institute, which will continue to develop 
and maintain the company’s language products. Financial details of the merger were 


Still de-fluffing C 


When Gimpel Software releases a new 

version of PC-lint - the program which takes 
all the fun out of C programming, by repor- 
ting the very code inconsistencies which 
make that language such a joy to use - we 
usually get to print a few lines of superfi- 
cially ok (but actually hopelessly bug-rid- 
den) code, so that You the Reader can test 
your expertise. The example provided with 
PC-lint 5.0, however, is too long for this. 
Never mind. 
The two new features which Gimpel is 
emphasising are stronger type checking 
and an extreme sensitivity to uninitialised 
variables - the latter achieved by an algo- 
rithm which follows control flow through 
the code, Other listed improvements in- 
clude a rude message when floats are 
tested for equality (you laugh, but I’ve 
known many a proper, paid programmer 
do this) and a ‘handsome new manual 
sporting real section numbers’. 

Gimpel is based in the US, so for UK 
prices we phoned Grey Matter (0364 53499) 
who quoted us £80 ex VAT for the DOS- 
OS/2 version and £130 for the (faster, larger 
capacity) 386 DOS-extender version. 


The Muse of objects 


Persistent Objects & Extended database 
Technology (POET) is a low-cost C++ ob- 
ject-oriented DBMS for DOS, Windows, In- 
teractive UNIX and the NeXT operating 
environments. There is a single API for all 
platforms and database files are binary- 
compatible across the different systems. 

Developed by Berlin-based software 
house BKS, the POET system implements 
C++ language extensions (such as per- 


sistent, transient and index 
keywords) through a pre-compiler which 
generates C++ v2.0 source code and header 
files. These are then compiled along with 
the user's application code by a native C++ 
compiler. The pre-compiler also supports 
templates for containers. In addition, there 
are various utilities supplied including a 
class browser (graphical under Windows) 
and a version control system for the class 
dictionary. 

Complete database facilities are provided 
including complex selection through pre- 
defined query classes, sorting and naviga- 
tion. The company is presently working on 
a multi-user client/server version of the 
product. 

Currently, most object-oriented data- 
bases are available only on high-end UNIX 
systems and are often prohibitively expens- 
ive. The single-user POET development 
system for Windows costs just £299 (ver- 
sions are available for Borland C++ 2.0 and 
Zortech C++ 3,0 compilers). It is distributed 
in the UK by Silicon River, a company re- 
cently set up by ex-Zortech directors and 
headed by former Zortech MD Paul Lea- 
thers. Silicon River is on 081 3177777. 


One all 


In a US court, Intel has failed to get an 
injunction against Cyrix, a manufacturer of 
competitively-priced 80x87 clone copro- 
cessor chips, to prevent Cyrix from ship- 
ping its coprocessors, Part Two: Intel has 
succeeded in getting an injunction against 
ULSI, also a manufacturer of competitively- 
priced 80x87 clone coprocessor chips, pre- 
venting ULSI from shipping its 
coprocessors. Both disputes concern al- 
leged infringements of Intel’s patents. 


System Architect not only has the power and flexibility to handle your most complex application, it is easy to 
use and affordable. As the only CASE tool to be specifically developed for MS Windows, System Architect brings 


you a graphics oriented, fully integrated multi-user development platform for PCs. 


In addition to standard CASE tool features, System Architect offers a wealth of additional functionality. 


Methodologies Supported 
¢ SSADM 

© Yourdon/DeMarco 

© Ward & Mellor 

© Object Oriented 

¢ Gane & Sarson 

¢ Information Engineering 


Full Data Modelling 
Lifecycle Support 


¢ Requirements Tracking 
¢ Analysis/Design 

° Prototyping 

© Schema Generation 

© Code Frame Generation 


Benefits 

Ease of Use 

¢ Readily Affordable 

¢ Networking 

© PC Based 

¢ Increased Productivity 
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Dictionary Set Style View Edit Window DEDDeMarco | 


Policy Billing and Collection 
Yourdon:-DeMarco 
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To arrange a demonstration, 


attend one of our regular System Architect seminars, 


or for further information please phone us on 


Tel: (0926) 450858 
Fax: (0926) 422165 


Supporting IBM’s AD/Cycle 


Real-Techniques and Methods Limited 
118-120 Warwick Street, Royal Leamington Spa, 
Warwickshire, England CV32 4QY. 


CIRCLE NO. 428 


Special Features 

¢ User Definable Attributes 

* Customisable Reporting System 
(Matrix and Tabular) 

¢ Automated Documentation 

¢ Import/Export/Extract/Merge 

¢ Multiple Document Interface 

¢ Import of External Graphics 

¢ CRUD Matrices 

© Mini-Spec Balancing 

¢ OS/2 Support 


Proven Reliability 


© Over 6,500 licences installed. 
Users include: 
¢ NCR ® Toshiba ¢ Racal 


© IBM ¢ Bull ¢ Prudential 


Training and Support 

Full training and support for both the 
novice and advanced user. Also 
training courses in Structured Methods 
and Object Oriented approach. 


™. 


System Architect 
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Oil and Water 

If you're having peculiar problems with 
code compiled with Borland C++ V3.0 
and linked to a library generated by 
Borland C++ V2.0, then stop trying. Bi- 
naries produced by V3.0 are (poten- 
tially) incompatible with V2.0; you must 
recompile librarysource from scratch, or 
contact your library supplier for an up- 
grade. This applies to Borland’s Turbo 
Vision and OWL libraries, too, 


Real Time Lib++ 

Capsule is a new general purpose C++ 
class library from Microtec Research. It 
contains a selection of container classes, 
such as singly and doubly linked lists, 
circular lists, stacks, queues and hete- 
rogeneous linked lists etc. Capsule also 
provides error detection and application 
specific classes derived from these base 
classes, including classes to handle Post- 
Script or graphics output and 
string/numeric conversions etc, Applica- 
tions developed under Capsule can be 
debugged using Microtec’s own Xray de- 
bugger. Capsule costs £390. Microtec is 
on 0256 57551. 


Energize C/C++ 

The Energize system from Lucid Inc is a 
new Client/Server C/C++ programming 
tool set for SPARC workstations which 
integrates into the UNIX environment 
and provides object-oriented develop- 
ment tools. The tool set contains the GNU 
Emacs editor and the GNU debugger, as 
well as Lucid’s own Cand C++ compilers 
which provide incremental compiling. 
The Server part of Energize provides an 
object-oriented database for storing the 
all the program information when more 
than one developer is working on the 
code. Several browsing tools have also 
been included to simplify the navigation 
through code. Energize costs $3250 for 
a single user licence and is distributed 
by Lucid Inc on 010415 3298400. 


Foxy CodeBase 

CodeBase V4.5 is the latest incarnation 
of Sequiter’s multi-user database man- 
agement library for C, C++, Visual Basic 
and Turbo Pascal for Windows. In ad- 
dition to supporting dBASE, Clipper and 
FoxPro, CodeBase now supports dBASE 
IV and FoxPro V2.0 CDX compound 
index file formats. Fox's new CDX for- 


index files which means that less data 
has to be read or written to disk. This 
results in applications that run faster. 
CodeBase V4.5 costs £255 and is dis- 
tributed in the UK by The Software Con- 
struction Company on 0763 244114. 


Solaris 


Sunsoft, the system software subsidiary of Sun Microsystems, has introduced a new 
32-bit operating system called Solaris which will be available on both the Intel 80x86 
and SPARC platforms. Applications developed for Solaris on these platforms will be 
source code compatible, enabling developers to write applications capable of run- 
ning on both platforms (the source code will only need to be re-complied). 

Solaris is based on SunOS V4.1.1 (which incorporates UNIX System V Release 4) 
and offers a 32-bit multi-tasking, multi-processing and multi-threading operating 
system. It provides an Open Look desktop with 14 applications including a file 
manager, networked calender and a mail application, The Solaris development 
environment includes a C compiler, XGL graphics libraries and 57 F3 fonts. Network 
administration is simplified using the ONC (Open Network Computing) protocols 
which can run on all major operating systems including DOS and VMS. This enables 
distributed applications to be developed across heterogeneous networks. 

Solaris V1.0 for the SPARC platform is currently only available to OEMs. Sunsoft 
expects to ship Solaris V2.0 in the third quarter of 1992. This will support both Intel 


mat significantly reduces the size of 
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Screen Machine Lite 


Magnifeye, UK distributor for German 
multimedia company Fast GmbH, has an- 
nounced that it is now shipping the Screen 
Machine Lite, a 24-bit image digitiser and 
real time capture card for AT-compatibles. 
The Lite comes with a complete image cap- 
ture application called Screen Machine 
Photo which enables users to grab frames 
of video from almost any video source. The 
same software, which runs under Windows 
3.0, allows the captured images to be 
cropped and compressed using the JPEG 
standard and converted into one of the 15 
image formats supported (including TIFF, 
GIF, PCX, RLE and TGA). Colour balance 
and saturation can also be adjusted. 

Screen Machine Lite supports NTSC, PAL, 
VHS and S-VHS so that camcorders, VCRs 
and laserdisks can all be used, including the 
Canon Ion still video camera. The card fits 
into a 16-bit slot in any AT-compatible and 


and SPARC platforms. For more information contact Sunsoft on 0494 472900. 


SOIHAVHD SSANISNE GSONVAGY 


requires 2 MB RAM, a mouse and a VGA 
monitor. The card plus software costs 4495 
+ VAT and can be purchased from Magni- 
feye on 071 2218024. 


ObjectStore for Windows 


Previously available only on UNIX plat- 
forms, ObjectStore object-oriented data- 
base management system (ODBMS) is now 
available in a Windows version. 1992 looks 
like being the year of the ODBMS with 
ObjectStore for Windows being the second 
Windows-hosted product to be released in 
the last two months (see POET elsewhere 
in News). 

Developed by American company Ob- 
jectDesign, ObjectStore for Windows is 
available in standalone and LAN-based 
client/server versions. The product has 
three principal components: the run-time 
ODBMS, the application interface (API) 
and a set of C++ development tools. 


Deep 


C Diving. 


Without the lead boots. 


When you've been in the Compiler business as 
long as we have you find out a few things. Like 
the importance of DOS and Windows Development 
Environments and DPMI support. That's why with 
half a million programmers already using Borland C 
and C++ products, our 3rd generation C/C++ 
compiler is about to make an even bigger splash 
than ever. 
Borland C++ 3.0 
£299.95 + VAT 


BORLAND C++ 


Borland C++ 3.0 
and Application 
Frameworks 
£439.95 + VAT 


As well as all the features you would 
expect from a professional compiler, such 
as customisable Global Optimisation for 
both size and speed, AT&T 2.1 C++ and 
ANSI standard C compilers, you also get our 

prize winning Turbo Debugger for DOS and 
Windows, Turbo Profiler and Turbo Assembler. 

And just so you won't get cold feet about diving 
into the world of C++, we've designed Application 
Frameworks, full of user interface objects that you 

*Free with Borland C++ 3.0 & Application Frameworks whilst stocks last. 


BORLAND 
SO FT WARE 
KNOW HOW 


Borland International (UK) Ltd 
8 Pavilions, Ruscombe Business Park 
Twyford, Berkshire RG10 9NN. Telephone 0800 212727 


CIRCLE NO. 429 


4on 
vw ne 


Nu 
fo 


can bolt right onto your code to create great looking 
applications under DOS or Windows. We've even 
included the source code. 

And because we know the importance of fast 
development, the visual ObjectBrowser lets you see 


through classes, functions and variables to make 
changes without ever 
leaving the integrated 


f ql eat Windows environment. 
j EE EON, ele EasyWin library even 
Windows 


| | 
|... = | lets you re-compile DOS 
Ea se | mete applications to run under 
is Windows without changing a 
line of code. 

Introducing Turbo C++ for Windows, the quickest way 
to create Windows Applications. With inbuilt tutorials, 
context sensitive help and ready to use examples, together 
with the ObjectWindows Library full of bolt on user 
interface objects now you can create Windows appli- 
cations fast. For more information or for upgrade details, 
take a deep breath and call FREE on 0800 212727 or 
complete and return the FREEPOST coupon today. 


All Borland products are trademarks or registered trademarks of 
Borland International. Other brand product names are trademarks of 
their respective holders. Copyright © 1991 Borland International Inc. 
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Postcode Tel. 


Please return this coupon to: 
Borland International (UK) Ltd. 
FREEPOST RG1571, TWYFORD, Berkshire RG10 8BR. 
Telephone 0800 212727 


‘G7_Nu-Mega 


| TECHNOLOGIES INC | 


Debug Windows at the systems level! 


Soft-ICE/W takes you inside Windows! Debug and explore with power 
and flexibility not found in any other Windows debugger! Soft-ICE/W 
allows you to debug at the systems or applications level or simply learn 
the inner workings of Windows. 
e Debug VxD's, drivers and interrupt routines at source level 
e Debug interactions between DOS T&SR's and Windows Apps 
e Debug programs in DOS-boxes 
e Display valuable system information 
(from the total memory occupied by a Windows application, to the 
complex internal structures of Windows) 


Soft-ICE/W uses the 386/486 architecture to provide break point 
capabilities that normally require external hardware, Nu-Mega, which 
pioneered this technology with the introduction of its award winning 
Soft/ICE for DOS, now gives Windows programmers the same debug- 
ging power... and still at a software price. 


Own the debugger that combines the best “view” of Windows internals 
with the most powerful break points of any software debugger. 


Soft-ICE/W ... Only £259.00 «var 


CodeView for Windows users: see what you're debugging without flash. 
CV/1 version 2.0 runs CodeView in a graphics window while viewing your 
application screen, Runs on any display that supports Windows. 


CV/1 eee Only £95.00 svar 


Tel: (071) 833 1022 Now in the UK RISK = NULL 


Fax: (071) 837 6411 System MONEV-BACK GUARANTEE 


3-5 Cynthia Street, 


London N1 9JF Science 


MICROSOFT WINDOWS IS A REGISTERED TRADEMARK OF MICROSOFT CORP. Soff-ICE/W AND CV/1 ARE TRADEMARKS OF NU-MEGA TECHNOLOGIES, INC, 
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WHAT THE EXPERTS ARE SAYING 


“Soft-ICE for Windows is great! It helped me 
find, in fifteen minutes, a killer bug ina 
Windows virtual device driver that had 
eluded two people for several months. | 
can't see doing Windows development of 
any kind -- whether writing Windows 
applications, device drivers, or even DOS 
programs that have to run under Windows -- 
without it. In addition to being great for 
finding bugs, Soft-ICE for Windows has been 
essential for my work on a forthcoming book: 
on Undocumented Windows. Soft-ICE for 
Windows goes anywhere and does 
everything, so it's essential for anyone who 
wants to poke around inside Windows 
Enhanced mode. DOS programmers will find 
it a perfect way to learn how the Windows 
DOS extender and DPMI server work, and 
how Windows interacts with DOS. Windows 
Enhanced mode is the hacker's paradise of 
the 90s, and Soft-ICE for Windows is the tool 
that every serious Windows or DOS hacker 
willneed. Nu-Mega has done a brilliant 
job!" 


Andrew Schulman 
Software Engineer, Phar Lap Software 

Editor, 

Coauthor, Undocumented Windows (forthcoming) 


The run-time environment performs all 
necessary object management and storage. 
The client/server implementation supports 
all NetBIOS-based PC networks (eg Novell, 
Banyan VINES and LAN Manager) and PC 
NFS for interoperability among PC and 
UNIX-based systems. 

The API provides access to the run-time 
system using either a C or C++ library inter- 
face, All popular C and C++ compilers are 
supported including Borland C++, Micro- 
soft C and Zortech C++. 

Windows-hosted development tools 
consist of SchemaDesigner - a graphical 
database design tool, and The Browser - a 
tool for inspecting the contents of an Ob- 
jectStore database. 

Unlike the POET ODBMS, ObjectStore 
for Windows doesn’t come cheap. A stan- 
dalone (single-user) development kit will 
leave a hole in your pocket the size of 
§3,495. Multi-user network versions start at 
£10,000. ObjectStore for Windows is avail- 
able in the UK from Sema Software Tech- 
nology on 0249 656194, 


Faster Windows 


The GainTEC GXA card is a new high- 
performance graphics adapter which is 
specifically designed to improve the perfor- 
mance of applications running in a GUI 
environment. The company claims that the 
card will deliver a 40% improvement over 
IBM’s XGA card on Windows-based soft- 
ware, and is up to 10 times faster than most 
Super VGA cards. It plugs into either a 
16-bit AT-type (ISA) slot ora 32-bit EISA slot 
and comes with 1 MB on-board VRAM. 

Like IBM’s XGA, the GXA provides dedi- 
cated hardware support for the major GUI 
functions using high-level commands, and 
thus eliminates most CPU and I/O intensive 
operations. All standard display resolutions 
are supported up to 1280 x 1024 in 16 
colour mode, 1024 x 768 (non-interlaced) 
in 256 colours and 640.x 480 in 65,536 


colours. A comprehensive range of soft- 
ware drivers is supplied with the card, pro- 
viding support for most major GUIs, CAD 
systems and DOS applications. It is 100% 
VGA-compatible and offers full backward 
compatibility with CGA, HGC and MDA. 
The GXA costs £345 + VAT and is avail- 
able from Scene Double on 081 9583639. 


DOMS 


HyperDesk has unveiled its Distributed 
Object Management System (DOMS) which 
provides software developers with a set of 
tools for building and integrating dis- 
tributed applications over a number of plat- 
forms including PCs, workstations and 
servers. Based on the Object Management 
Group’s Object Request Broker (ORB) 
standard, DOMS is claimed to simplify ob- 
ject access in APIs, Remote Procedure Calls, 
network protocols and operating systems. 
It runs under both DOS and UNIX and 
supports Windows and Motif. 

The HyperDesk Distributed Object Man- 
agement System Development Kit costs 
$1995 (single user licence), Contact Hyper- 
Desk Corporation on 010508 3665050 for 
more information. 


Dolphin Libs 


The Dolphin C Toolkit is a C library for 
Microsoft C and Borland C/C++ which con- 
tains 225 miscellaneous functions including 
printer functions that interface with the DOS 
print spooler to allow background printing 
and functions for determining the type of 
disk present and for performing a software 
reboot. A Far Memory Manager and De- 
bugging Library contains functions for ana- 
lysing the far heap plus routines which 
dynamically allocate multi-dimensional ar- 
rays at run-time. The Dolphin C Toolkit 
costs $149 and the Far Memory Manager 
costs us $99, For more information contact 
Dolphin Software on 010510 4643009. 


-EXE in 1992 


You may notice some changes in this month’s .EXE Magazine. Our readership 
survey suggested that C programmers wanted more C stuff, whereas non-C pro- 
grammers wanted anything else. To try and accommodate everybody, we have 
replaced ‘Code Page’ with four new regular columns, ‘IC’ (ie ‘logical NOT C’) is for 
practical, codey articles in anything except C; ‘xBASE’ is a pied-d-terre for the Foxy 
and the Clipperish and friends; ‘Laine Stump’s C++ Diary’ will also be down-to-earth; 
and ‘CUG’ will provide a point of contact with the C User’s Group, with the European 
C++ User’s Group to follow soon. ‘The Third Side’ retires from our regular line up, 
although we hope to bring it back from time to time as a ‘Special’. Stalwart columnists 
Peter Collinson and Jules May plough their lonely furrows as before. 

When you have had a look at our efforts and cast this magazine aside in disgust, 
please write and tell us exactly why we should have left well alone, and anyway .EXE 
is not half as good as it was two years ago. Our Letter of the Month competition, now 
sponsored by Just Computer Books, offers a £20 book voucher as the prize for the 
best letter; writing fawning letters will not help you win it. Well, maybe. 


News 


Soft Mouse 

NoMouse is a software replacement for 
the mouse, providing precise pixel con- 
trol in Windows applications. It enables 
users of laptops and notebooks - not to 
mention those whose rodent has bust - to 
run Windows applications efficiently, 
without the need for a physical mouse, 
It includes the EasyFind utility which 
enlarges the standard mouse pointer, 
making it easy to see on LCD screens. It 
allows you to use short-cut keys to move 
quickly to the sides and corners of a 
window. NoMouse costs £39.95 and is 
distributed by GuildSoft on 0752 
606200. 


Affordable CASE 

Personal-SELECT SSADM is a low-cost 
DOS-based CASE tool that provides sup- 
port for both versions 3 and 4 of the 
SSADM methodology. The usual CASE 
features are all supported including 
data flow diagrams, entity life histories, 
logical data structures and, of course, a 
data dictionary. Versions are also avail- 
able which support Yourdon and HOOD 
methodologies. Personal-SELECT costs 
£495 for a single-user version and £995 
Jor a multi-user network version. It is 
published by SELECT Software on 0242 
220553. 


Watcom GO Pen 

Watcom has announced an agreement 
with the GO Corporation, under which 
Watcom will supply the 32-bit C compiler 
Jor GO’s PenPoint Software Development 
Kit. PenPoint is an object-oriented oper- 
ating system, specifically designed for 
pen-based computing. The Watcom 
compiler is hosted under DOS or OS/2 
and enables the development of applica- 
tions for PenPoint on 32-bit Intel 80x86 
systems. Version 1.0 of the PenPoint SDK 
is due to ship in the first quarter of this 
year. 


Maastricht Conference 

No, not another EC summit. The Fourth 
International Conference on Image Pro- 
cessing and its Applications (IPA), or- 
ganised by the Institution of Electrical 
Engineers, will be held in Maastricht in 
the Netherlands from 7-9 April 1992. 


More Shareware 

We looked at EMS’s C++ shareware li- 
brary in our November 91 issue; now 
the company has introduced two new 
libraries: WINLIB(MS-Windows utilities, 
drivers, interesting bitmaps etc) and 
ABUtility (includes programs for dBASE 
III/IV, FoxPro, Clipper etc). Both li- 
braries are US $149 ex delivery, call 
0101 301 924 3594. 
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Letters 


Letters 


We welcome short letters on any subject that is relevant to software development. Please write to 
The Editor, .EXE Magazine, 10 Barley Mow Passage, Chiswick, London W4 4PH. Unless your letter is 
marked ‘Not for Publication’, it will be considered for inclusion in this section. 


A Typical Reader... 


Sir, 

I was very pleased to read the results of 
the .EXE Readership Survey, Although I did 
not take part in it, as a relatively new sub- 
scriber, I should like to congratulate the 
team for the innovative way (disk based) 
and the effort gone into obtaining unbiased 
results, 

Needless to say that I match the results of 
the survey to an uncomfortably close de- 
gree in practically every aspect, except that 
Tam now 50 and currently unemployed. 

I entered software engineering about 12 
years ago from electronics by designing 
embedded system controllers and data ac- 
quisition systems, a skill for which demand 
fell off very rapidly. 

Networking is now the name of the 
game, but without formal qualifications in 
Computer Studies I would have remained a 
‘grease-monkey’ had it not been for my 
courage to enroll at Middlesex Poly for a 
fresh HND. 

However, my recent efforts on job hunt- 
ing have revealed that prospective em- 
ployers prefer youngsters with minimal 
experience, although us old-timers, for not 
alot more, would seem to offer much better 
value for money. 

Since the bulk of your readership is 
middle-aged, it would be a very interesting 
to research into the future prospects of 45+ 
ages by finding out how the existing ones 
are doing. 

Last, but not least, I should like to con- 
gratulate all the staff for the excellent pres- 
entation of the magazine and especially for 
the editorial manner adopted, which makes 
everything fun to read. 

The introduction of classified ads will 
benefit both the magazine and the industry 
it serves, especially during these hard days. 


Mr C Papazissimou 
London NW2 
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OS/2 Babel 


Sir, 

I read with interest BJ Thomson's article 
on character sets (Software Sans Frontiéres, 
.EXE December 1991), | have two points to 
make. 

First, OS/2 PM programmers do not need 
to write their own equivalents for the An- 
siNext () andAnsiPrev () functions 
- OS/2 comes with two functions, Win- 
NextChar() and WinPrevChar(), 
to do this, OS/2 also has WinUpper- 
Char () and WinUpper () which con- 
vert a single character or a string of 
characters into upper case. For some un- 
known reason, however, there is no lower 
case equivalent! 

Second, one problem which was not ex- 
plicitly mentioned was the input and dis- 
play of numbers with decimal points. We 
English speakers are used to using a period 
(.), but many other languages use a comma. 
Writers of programs to be portable to other 
countries need to beware of code such as: 
sscanf( ipbuf, "%f", 


&fval); 


since sscanf () will expect the input buff- 
er to contain a period and will not process 
input containing a comma correctly. 

As a further complication, other lan- 
guages use the period, or some other char- 
acter, where we use a comma to separate 
thousands. So, for example, 1024 can be 
written as ‘1,024 in English, whereas na- 
tives of many other countries in Europe 
would prefer ‘1.024’. 

It isa shame that, as far as 1am aware, no 
standard PM function exists to provide the 
equivalent of WinQueryDlgItem- 
Short () for floating point numbers. Per- 
haps.systems developers stick to integers! 


Roger Orr 
London 


Stepstone 


Sir, 

Your recent article ‘Of Bullets and Mus- 
kets’ (.EXE, October 1991) by Al Roth, 
printed information that was not only erro- 
neous, but extremely damaging to the repu- 
tation of The Stepstone Corp. 

In this article Dr Brad Cox, ex-Chief Tech- 
nical Officer of Stepstone, was quoted as 
saying ‘Stepstone is essentially out of busi- 
ness... it’s reasonably public.’ At no time 
was Stepstone out of business. 

In April 1991, Stepstone went through a 
major financial reorganisation. Since that 
time, for the first time in the history of the 
company, Stepstone is surviving without 
the funding of venture capital groups. We 
continued to support our customer base 
throughout the reorganisation. 

We have hired back ex-employees, and 
are announcing three new products in the 
first quarter of 1992; Objective-C for the 
Macintosh, the Objective-C Interpreter for 
the SUNs, and ICpak 101 for the NeXT 
station. 

The enthusiasm of our employees and 
their belief in the superior technical at- 
tributes of our products has kept our com- 
pany alive and growing. 


KK Tan 

President 

The Stepstone Corporation 

USA 

We apologise for printing potentially mis- 

leading information, and are happy to set 
the record straight - Ed. 


QEMM saga #5 


Sir, 

I am able to confirm the claim by the 
Quarterdeck MD (.EXE Letters, Nov’9D) that 
users keep stumbling over ‘unpromoted’ 
features. However, these may not be quite 
as fabulous as he believes. 


A year ago I returned a Quarterdeck 
‘more info’ coupon and ringed several 
Bingo cards, all to no avail. It took a mildly 
sarcastic letter to obtain information on 
QEMM and DESQview. The products were 
ordered, but on delivery a disk proved 
faulty. So did a replacement set. The third 
set was OK but the auto-install was not. It 
made various errors, some as elementary as 
copying QEMM386.SYS to a \QEMM direc- 
tory, but omitting this path from its CON- 
FIG.SYS modifications. Other errors were 
less obvious, The machine was a new, 
‘clean’ 386 with 8 MB RAM so there were no 
complications. Now I have found that 
Quarterdeck has no record of my registra- 
tion card. A letter to Quarterdeck setting out 
the above in more detail has yet to bring a 
response. 

What of the products themselves? No 
complaints about QEMM, once the instal 
errors had been traced and corrected. The 
clarity of the manuals is not helped by the 
excessive repetition of the company brand 
names. Over 20 per page is typical, on one 
page I have noticed 26 mentions. DESQ- 
view has proved less useful than antici- 
pated, Perhaps I could use it more often - 
should like to use it with Windows without 
it crashing on exit - but the time spent 
removing the wrinkles often becomes 
greater than the maximum time it could 
possibly save in actual use. Investments, 
whether of time or money, need to be jus- 
tified by results. 

Mr Poel says he would like .EXE readers 
to be more positive. Perhaps he could set 
us an example first? 


Bob Rimmington 
Burgess Hill 


DR-DOS 6.0 is ok 


Sir, 

I am writing to you with reference to 
Ian Butterworth’s letter (EXE Nov '91). 
His client had apparently experienced 
problems running Clipper Summer '87 
programs under DR-DOS 6.0. I find this 
rather puzzling. My company, A C K Data, 
has several applications amounting to 
around 5 MB of source code, all in Sum- 
mer ’87, which have been running under 
DR-DOS V6.0 for the last month with no 
problems whatsoever. 

I wonder if Mr Butterworth’s clients’ com- 
puter was running with data compression? 
Our systems are set up with no data com- 
pression, but we are running the disk cache 
and task-switcher. Ina computer with more 
than 1 MB RAM, DR-DOS will use the ex- 
panded memory, or will set up extended 
memory to look like expanded memory 
(using EMM386.SYS or EMMXMA.SYS), de- 
pending on the options selected during 


installation. If expanded memory exists, 
Clipper software will use it - potentially 
causing a conflict with software such as the 
disk cache or task-switcher. Stop Clipper 
using expanded memory by entering 


SET CLIPPER=E0 


at the DOS prompt. Normally, use of LIM 
memory should not cause this sort of prob- 
lem - it’s just that Clipper Summer ’87 (I 
suspect) may not be too well behaved in 
this area. 

I would be interested to hear from 
anyone else who may have experienced 
difficulties running either Summer ’87 or 
V5.01 under DR-DOS V6.0. 


Michael Towle 

ACK Data 

Nottingham 

We also understand that Summer ‘87's 
handling of expanded memory is bugged - 


Bugwatch 


Sir, 

Further to Dave Riley’s letter (EXE, June 
1991), | have tracked down another poten- 
tially dangerous bug in the Microsoft C ‘op- 
timising’ compiler V6.0. The bug only 
occurs with optimisation on (default) and 
is demonstrated by the following program 
(small memory model); 


#include <stdio.h> 


static char output, input = 4; 
void main(void) 
{ 
unsigned x; 
int fd, £h; fm, fs; 
char da, ho, mi, se; 
da = (char) (x + 1); 
ho = (char) (x + 2); 
mi = (char) (x + 3); 
se = (char) (x + 4); 
output = 
(char) ( 10 * input ); 


printf ("%d", (int) output); 


fs = fd + se; 
fm = mi + fs 
fh = ho + fm; 


The program should of course print out 
40, but the value that actually gets output is 
unpredictable and depends on the contents 
of the DH register when main () is en- 
tered. 


Letters 

Examination of the assembly code pro- 
duced by the compiler reveals that the op- 
timiser correctly ‘ignores’ the first four and 
last three instructions (since they only oper- 
ate on local data they are redundant), If 
these lines are taken out of the source file, 
however, the compiler generates correct 
code! The error occurs because the com- 
piler is trying to use a ‘clever’ method of 
multiplying by 10, thus avoiding use of the 
MUL instruction. Although using the MUL 
instruction would result in faster and smal- 
ler code for a 286 or 386 processor, the 
compiler still insists on doing it this way 
when the /G2 switch (generate 286 code) 
is used! 

The moral of this and the conclusion we 
have come to here is always to disable 
optimisation when using MS C V6.0. 


Patrick Johns 
AGB International 
London 
PCL #1 
Sir, 


My December copy of .EXE was accom- 
panied by a subscription invitation. Hmm! 
Possible, until I read the rubbish offered by 
Peter Flynn as a review of PCL. 

We have software running in over 20 
countries using the PCL run-time environ- 
ment, no licence issues here. All of it uses 
communications, via PSTN, Public Packet 
Switching, in-house PADS, and the like... 
Peter Flynn ‘wasn’t able to make it (the 
terminal emulator) work anywhere.’ 

His is the sort of review that gives ‘aca- 
demic computing’ a bad name in the com- 
mercial environment. 

My subscription? Take it out of the fee 
that you paid for three pages of shredder 
fodder. 


Russell Hunt 
Managing Director 
Applications Systems 
Hampshire 
PCL #2 
Sir, 


I read with much interest your review of 
the PCL compiler/interpreter in the Decem- 
ber issue. I've been using PCL regularly 
since 1988, both for my work with IPS and 
for the independent work I do for some 
other news organisations. I’ve all but 
thrown out my other compilers because 
PCL is so fast and easy to use and has 
assembler functions to do the nasty stuff. 

The main comment I would like to make 
to the review’s author is that the Terminal 
function in PCL has never failed me. Most 
of my work involves RS-232 communica- 
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tions, so almost the first thing I do when I 
sit down in front of a client’s computer is 
run Terminal and look at the serial ports. It 
always works, just like everything else 
with PCL, and it’s dead easy. I can’t imagine 
what he was doing wrong unless he had 
nothing connected to the port. 

I do, however, heartily agree with him 
that it is a shame PCL doesn’t allow the 
generation of .EXE and .COM files. But for 
his information, and that of your readers, 
should point out that the run-time module 
of PCL may be distributed without any 
license fees, as the PCL documentation 
points out. 

I have done this numerous times and 
once - when I ran up against an early Tulip 
286 on which it wouldn’t run (and which 
Tulip later admitted was making some 
spurious BIOS calls) - I had recourse to the 
Calend help line and found it offered 
straight away the information I needed. 
They only found it natural that I had dis- 
tributed the run-time module to my client. 


John Clements 

Technical Director 

IPS 

London 

We apologise for the inaccuracies in the 
PCL article - Ed. 


Hypermedia 


Sir, 

I was interested to read the article by Dr 
Pickard, and also the letter published in 
your column by Jules May (EXE Nov '91 
and Dec '91). 

It is our belief that hypermedia, and ap- 
plications of these techniques to communi- 
cations, will have a tremendous impact on 
our everyday lives and I found both Richard 
Pickard and Jules May’s articles very 
thought provoking. 

However, it is not easy to distinguish 
between teaching and learning or enter- 
tainment if you take arguments used when 
discussing hypermedia to their logical con- 
clusion. 

After all, we have only recently finished 
riding the wave of consumerism which has 
fuelled the development of the personal 
computer and funded practically every 
other activity in our modern day society. 

In a consumer society, training is just a 
way of instructing its members how to pro- 
duce more efficiently. Advertisements are 
just a way of training its members how to 
consume products more efficiently. 

Most entertainment on our TV screens 
each night is merely the soft selling of pro- 
ducts, even if the goods are not paraded 


Letters 
before us as they are in game shows. The 
values we must aspire to as good consu- 
mers are certainly put before us or sug- 
gested in everything from EastEndersto The 
South Bank Shou. 

For the last 40 years we have gradually 
become what we consume, and the com- 
munications industry has grown fat by 
feeding off the consumers’ and producers’ 
need to communicate. It will, therefore, be 
interesting to see what effect multimedia 
and hypermedia has on our society. 


Peter Kruger 
Digithurst Ltd 
Herts 


Letter of the Month 


We have a hot, new sponsorship 
deal for 1992! The writer of the 
best letter of the month, as 
judged by the Editor, will receive 
a £20 Book Voucher, courtesy of 
Just Computer Books. The best 
letter is the one printed first. 
Please note that letters submitted 
to this page may be edited. 


Still waiting for your job 


YOU SHOULD BE USING 


UNISPOOL AND UNIBATCH 


SYSTEMS MANAGEMENT TOOLS 


from Unisystems - UNIX has never been simpler 


Unispool and Unibatch allow you to manage your print and job scheduling 
via easily understood screens and simple to use ring menus. 


These proven products are available for a wide range of Unix Systems. 


UNISPOOL 

© Full print job queue and printer activity 
displays 

* Multiple print queues 

¢ Any number of printers 

* Any type of printer 

* Printer selection by form number 

* Printing suspension and restart 

¢ Any number of copies 

¢ Forward and backspacing of pages 

* Printing restart by page number 

¢ Supports networked printers 

¢ Plus many other features 


Unisystems 


UNIBATCH. 
¢ Full display of active, held and pending jobs 


by user / department / company 

Multiple job queues 

Concurrent batch processing 

Conditional job execution 

Jobs can be held for later release 

Jobs can be run at a specific time / day / date 
Job abortion and re-submission 

Conditional job execution 

Sets and changes priorities 

Plus many other features 


Parchment House, Northburgh Street, 
London EC1V 0AH. 


Telephone no: 071-251 2553 
Fax no: 071-608 1081 
All Trademarks Acknowledged. 


CIRCLE NO. 431 


Please send me more information 
about Unispool [_] or Unibatch [_] 
or contact me[_]. 


SIMPLY THE BEST 


Between Relational and Network when Raima Data Manager has both and now MUCH MORE 


The Raima Data Manager dbms is intended for use by the professional C 
applications developer. Raima is written in C and provides a complete set 
of sophisticated development tools that feature: 

© High speed access to large or complex data 

@ Mainframe functionality 

@ Portability to any C environment 

© Royalty-free run-time distribution 

@ Source code available in C. 


Raima provides both Relational and Network model technology for 
programming flexibility. Retrieve a record using the relational keyed access 
method and all related records can be immediately available using the 
network database model. 


db_QUERY provides SQL-like access to Raima, callable from within an 
application, db_REVISE allows restructuring of live databases. 


Raima is fast. Access times for retrieving data are largely independent of the 
size of the database. 


Raima is portable. Develop an application in any environment and your 
database access code can be ported without change to any other supported 
environment. Currently, Raima supports MSDOS, MS Windows, OS/2, 

QNX, UNIX System V and Berkeley, Ultrix and VMS. 

Raima Data Manager dbms is a product of Raima Corporation and has been 
sold to thousands of C programmers in over 50 countries. Raima is fully 
supported in the UK and Eire by Systemstar Ltd. Comprehensive training is 
available together with bespoke system development. At Systemstar we offer 
C-scape 3° screen interface library with Look and Feel” from Liant Software 
Corporation to provide Raima programmers with a complete application 
development environment. 


For more information about Raima Data Manager dbms, 
db_QUERY, db_REVISE and C-scape 3 call Systemstar 
in Hertford on (0992) 500919. 


NEW 


Support for NFS 

Object Manager Class Library 
Protected Mode for MS-DOS 
VISUAL BASIC support for Windows 


FEATURES 


~< 
m 
“a 


Single and multi-user available 


Relational B-tree indexing 


Network database model 


L 


Multiple database access 


Referential integrity 


Transaction processing 


Automatic recovery 


Record and file locking 


KISISIS ISI SIS IS 


RAM resident 


Relational Query and report writer 


Total database redesign/restructuring 


C compilers: most supported 


C ++ compatible 


Operating Systems: VMS, Ultrix, 


UNIX, BSD, SunOs, QNX 


MSDOS, OS/2 


Windows 3 


LANs: Netbios and NFS 


Read and write WKS, WIK1 and DBF files* 


Source Code available 


Training courses available 


KIC ICICI ICICI I IKI 


Run-time Royalties (Absolutely NOT) 


*using WKS Library 


1-3 PARLIAMENT SQUARE HERTFORD SG14 1EX 


TELEPHONE: (0992) 500919 — FACSIMILE: (0992) 554261 


Browsing with Clipper 


Practically browsing 
with Clipper 5.01 


Nantucket’s Clipper 5.01 is worth getting to grips with if you’re prepared to leave your old 
XBASE code behind. James Ormrod shows why with a configurable, saveable TBrowse. 


antucket’s Clipper 5.01 has proved to be 
a bit of an enigma: less than fully object 
oriented, more than just another xBASE 
product, a little C-like and not at all like 
dBASE, the Clipper ’87 developer moving 
to 5.01 needs to do more than just assimilate 
extra features and functions - he needs to 
bsorb a whole new philosophy and prob- 
bly change their programming style. 


Ses) 


he key to making the move to 5.01 is to 
hink modular’, to enlist 5.01’s new fea- 
tures as allies in the battle against complex- 
ity, and to reject some of the old Summer 
’87 features. 


a3 


Why bother? As always, it depends on your 
needs, If you want to knock something up 
‘or a one-off user quickly use a 4GL or grab 
a copy of Dataease or Foxbase. If you want 


to construct a core business or complex 
application that will have a wide distribu- 
tion and a long life, use Clipper 5.01. The 
resulting system will be robust, fast, easily 
maintainable and extensible. If you should 
then go on to develop more applications 
you'll be able to reuse large chunks from 
the previous one, a situation that gets better 
and better the more applications you de- 
velop. 


Reusability has been described as the ‘Holy 
Grail’ of software development, but is ac- 
tually a by-product of modular design, If 
you ‘think modular’ your code will auto- 
matically be reusable. The rest of this article 
looks at combining Clipper 5.01's new fea- 
tures with modular design to build a reu- 
sable file browser with an object-oriented 
flavour. 


5.01 Concepts 


5.01 presents the new user with a bewilde- 
ring array of new concepts, many of which 
are more familiar to a C programmer than 
to a Summer ’87 user. It’s easy to be put off 
and to rely on familiar techniques. Many 
developers have still not moved to 5.01 and 
of those who have, the majority are still 
writing Summer ’87 code. This is a pity 
because 5.01 is not very good at compiling 
Summer ’87 code and is in any case a far 
superior development language. The major 
concepts used in the code presented in this 
article are covered below. Figure 1 illus- 
trates the pre-processor, including an 
example of a code block. 


Pre-processor - A batch-driven ‘search- 
and-replace’ feature. Patterns to match and 


#include "fileio.ch" 

]* 

#xcommand defines an extended user 

defined command which cannot 

be abbreviated to 4 characters: 
default cName to "" 


becomes: 

cName := iif(cName == NIL, "", cName) 
wh 
#xcommand DEFAULT <p> TO ; 


SS . 
<p>:=iif (<p> == NIL,,<p>) 


/* 
#xtranslate is similar to #xcommand 
but is commonly used where syntax will 
be "function-like". The code block 
illustrated has a parameter passed to 
it, cFile, which is assigned to the 
variable cF. cF is visible only within 
the code block. The block returns the 
result of evaluating the if() in this 
case a file handle. 


nHnd := OpenOrCreate("error.log") 
Will produce: 
nHnd := eval({|cF| 


if (file (cF), 


//Include Nantucket definitions for fopen()/fcreate(): 


fopen(cF, FO_READWRITE) ,; 


*/ 


=> 
eval ({|cF| 


/* 
volatile data. 


ay 


local nHnd,; 
cBuffer 


// Ete. 


return NIL 


fcreate(cF, FC_NORMAL)) ; 
}, "error. log") 


#xtranslate OpenOrCreate(<cFile>) 


if(file(cF), if 
fopen(cF, FO_READWRITE) ,; 
fcreate(cF, FC_NORMAL)) ; 
}, <cFile>) 


#define is used for constants and 
It is the only 
directive that IS case sensitive: 


#define BUFFSIZE 1024 


// Sample code using the directives 


function audittrail (cLog) 


:= space (BUFFSIZE) 
default cLog to “audit.1log" 


nHnd := OpenOrCreate(cLog) 


Figure 1 - Example pre-processor directives including a code block. 
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replace are specified either at the top of the 
source file or ina separate # include file. 
Pattern matching is performed before the 
program is compiled. The pre-processor 
has three main uses; it can enhance pro- 
gram readability, it can separate volatile 
data from the rest of the system making 
changes easier, and it can hide complexity 
by mapping user defined commands onto 
function calls (all commands except flow- 
control commands in Clipper are mapped 
to function calls in STD.CH). 


Code Blocks - A mechanism by which a 
variable can point to executable code. The 
code can be executed directly through one 
of 5.01’s EVAL () functions or indirectly 
via an object’s method. A Code Block is a 
little like a C pointer-to-function and can 
have parameters passed to it and return a 
value. 


Multidimensional arrays - An array in 
5.01 is more like an undeclared structure 
than the sort of arrays C programmers are 
used to: any element in any array can have 
any data type, including another array. 
Array names point to the array structure in 
a similar manner to the way pointers work 
in C, so the same array can be referenced 
by more than one variable, and references 
to arrays can be passed to and returned 
from functions without the array being co- 
pied. 


TBrowse object - an instance of the 
TBrowse class that contains the data (in- 
stance variables) and code (methods) re- 
quired to define and manipulate a browse 
table. A TBrowse object relies on one or 


more TBcolumn objects, each of which 
describes the formatting, display and con- 
tents ofa single table column. There are two 
other fixed classes in 5.01 - Get. objects are 
used to control data-input and an Error 
object is instantiated when a run-time error 
occurs. 


Static and local scopes - A local variable 
is visible only within the function in which 
it is declared and is destroyed when the 
function returns. A static variable has local 
scope, but is retained after the function 
returns, coming back into scope when the 
function is called again. A file-wide static 
variable is declared outside a function and 
is visible to all functions within the same 
source (.PRG) file. A static function may 
only be called by functions declared within 
the same source file. These scopes facilitate 
encapsulation by allowing the developer to 
hide data more efficiently than the PUB- 
LIC and PRIVATE scopes of Clipper ’87. 


The application 


A common technique in database applica- 
tions is to ‘browse’ a table of data. In its 
simplest form this involves displaying part 
orall ofa DBF file, each field corresponding 
toa column in the table. The user can then 
cursor through the table to view the con- 
tents of the file. Clipper Summer ’87 ex- 
tended this concept with the DBEDIT () 
function, which allowed the developer to 
specify the contents and formatting of each 
column and passed control to a configu- 
rable key-handler whenever a key was 
pressed, making it possible to build an en- 
tire user-interface around a browse table. 


flinclude "box.ch" 
#include "inkey.ch" 
function main() 


local i 13 // Array index 
ots = ,;_// Throwse object 
orc + // TB column object 


,i // Field name 

1i // Field get/set block 
nKP := 0 // Code of key pressed 
y* 
Open the file to browse & 
instantiate the TBrowse object: 
we 
oTB := TBrowseDB(02, 10, 23, 70) 
oTB: hr (196) +chr (194) +chr (196 
"+ chr(179) +" " 
he (196) +chr (193) +chr (196) 
use staff index empcode 
y* 
Instantiate a TBcolumn object for each 
field & add it to the TBrowse object: 


for i := 1 to fcount() 


fieldname(n) returns the name of field 
number n. fieldblock() returns a 
"get/set" code block for the field, 
which when EVALuated gets the value of 
the field & sets it to the new value 
if one has been passed. 


fieldname (i) 
fieldblock (cF1d) 
TBcolumnNew (cF1d, 


bGSet) 


oTB:addcolumn (oTC: 
next. 
/* 
Set the screen up & then pass 
control to the key-handler 


ae 

cls 

@ 01, 09, 24, 71 box B_SINGLE 

do while (nKP := inkey()) != K_ESC 
/* 


oTB:stabilize works incrementally & 
can be interrupted by a keystroke, so 
you don’t have to wait for the screen 
to redraw every time you press a key. 
uta 
do while ((! ofB:stabilize()) =; 
sand. (nKp := inkey()) == 0) 
enddo 
y* 


We used TBrowseDB() so these methods 
have been set up for us (this is just 


a sample): 
ra 
do case 
case nKP == K_RIGHT; oTB:right () 
case nKP == K_UP; oTB:up() 
case nKP == K_LEFT; ofTB:left () 
case nKP == K DOWN; oTB:down() 
case nKP == K_HOME; oTB:home() 
case nKP == K_PGDN; oTB:pagedown() 
case nKP K_END; = oTB:end() 
case nKP == K PGUP; oTB:pageup() 
endcase 
enddo 
return NIL 


Figure 2 - Basic TBrowse 


Ny 


Browsing with Clipper 


5.01’s browsing abilities are even more 
powerful, using an object-oriented ap- 
proach to make every aspect of the browse 
configurable. A TBrowse object can be 
configured to browse anything, in any 
order, including arrays, DBF files and even 
binary files. Once configured, columns in 
the object can be frozen or hidden spread- 
sheet-style, re-sized, swapped or removed 
without exiting the browse. Each column 
can have its own colour scheme and indi- 
vidual cells or groups of cells can be col- 
oured, Cells can even be coloured 
according to their content (negative num- 
bers appear red, for example). The key- 
handler for a TBrowse object is also 
totally user definable (DBEDIT () used to 
intercept certain keys for its own use) and 
you can even set keys up to behave differ- 
ently for each column in the table. 


A TBrowse object is configured by chang- 
ing its exported instances, which can also 
be interrogated. The ability to interrogate 
instances means the TBrowse object 
could be reconstructed from copies of its 
instances, which could be stored off-line 
and re-loaded when required. Following 
on from this, it should be possible to write 
a routine that allows a user to configure a 
TBrowse to his satisfaction and then to 
save it to a disk file, from which it could be 
reloaded, Such a routine could be included 
in shipped applications to allow power- 
users the flexibility to change their user 
interface or used as a productivity or proto- 
typing tool by developers. 


There is a catch (of course!) Neither Clipper 
objects nor code-blocks can be directly 
stored off-line, so some translation will be 
required, 


Configuring a browse table 
The steps involved in configuring and in- 
voking a TBrowse are as follows: 


Instantiate the TBrowse object with a call 
to TBrowseNew(). 


Initialise instance variables to control col- 
our, heading and column separators etc. 


Define and assign methods to control cur- 
sor movement etc. 


Instantiate a column object for each column 
in the browse table. 


Change the column’s instance variables to 
control width etc, if the default is not ac- 
ceptable. 


Define and assign a method to control the 
data source for each column. 


.EXE Magazine, Vol 6, Issue 8, February 1992 


15 


If you could create your own computer for 


THE 


developing software what would you build? 

You’d need a system to increase your 
productivity, one that helped you create 
applications in half the time it takes you 
now — and complete projects ahead of 


schedule! 
You’d want a true 
multitasking system with 


virtual memory. Because that 


would give you the kind of 


window while 
debugging in another, so if 


your new application should 


crash your whole system 
won't die. 

You'd give it plenty of 
power and speed to handle 
even the most complex 
projects, complete with 
UNIX and the Motorola 
68040 processor. 


With your users in mind, 


you’d want an Interface 
Builder so you could create 


an outstanding user interface — 


quickly and easily. 


And you’d want an object oriented 
programming environment so that you 
could reuse your software components 


and it would help if it came with a 


complete object library. 


Fortunately, there’s a computer 
that already offers this, the Nex’T 
computer. The tools provided by the 
NeX [step operating environment 


make it easy to develop 
advanced, user-oriented 
programs. 


So take the NeX’Tstep and 


call 081-565 0005 for more 


information, or fill out the coupon. 


© 1991 NeXT Computer. Alll rights reserved. The NeXT logo is a registered trademark, 
NeXT and NeX'Tstation are trademarks of NeXT Computer Inc. All other trademarks 


mentioned belong to their respective owners. 


CIRCLE NO. 433 


pocccccccccc 


somiputer that ULTIMATE 
will let you 

compile a 

program in one 


I’d like to receive more information on NeXT 


I’d like to receive more information on 
NeXT Developer Courses 


Please complete and return to: NeXT, 286 Bath Road, West Drayton, Middlesex UB7 0DQ. 


Name: 


Company: 


Address: 


County: 


Telephone: Post code: 


a a ee ee ee 


ltl Cs 


Add the columns to the TBrowse object. 


Stabilise the TBrowse object (which 
draws it on the screen), 


Pass control to the key-handler (usually a 
CASE statement). 


Most browse tables manipulate data from 
DBF files and TBrowseDB () is supplied 
to instantiate an object with default cursor 
movement methods for these. 


Figure 2 illustrates the steps involved in 
setting up a basic browse for a DBF table. 


Having configured the TBrowse object, 
our aim is to be able to save it to disk. Since 
we can’t write the object to disk directly, we 
must find a way of saving its unique instan- 
ces and methods so that we can reconstruct 
it by using them to configure a new object. 
Objects in 5.01 are physically implemented 
as structures which we can model using 
arrays. 


Saving and restoring arrays 


Clipper lacks functions to save and restore 
arrays to and from disk files, so we will need 
to write them. These will be useful addi- 
tions to our armoury, not least because they 
can be used as alternatives to the 5.01 
SAVE and RESTORE commands (which 
write/read variables to/from disk .MEM 
files), which only work with PUBLIC and 
PRIVATE variables. 


Code for a save array function is illustrated 
in Figure 3. The disk file created has an 
offset table at the top with the data follow- 
ing it. Each array has an entry in the offset 
table with the array name and the offset into 
the file at which its data starts, measured 
from the start of its offset table entry. 


As new arrays are added the file grows in 
both directions; the new offset table entry 
is inserted at the very top of the file and the 
data is appended to the bottom. This mech- 
anism ensures that the offsets of existing 
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arrays do not have to be adjusted when new 
arrays are added to the file. 


Not all Clipper data types can be saved in 
this manner: references to code blocks are 
created at run-time and cannot be stored 
off-line. Fortunately 5.01 includes a means 
of compiling code blocks that have been 
created as strings (‘stringified blocks’) using 
the & symbol, which will allow us to save 
and retrieve a block as a string and compile 
it later. 


Saving a TBrowse object 


An object in Clipper 5.01 can be ‘converted’ 
to an array by adding an element to the 
array for every exported instance variable. 


Methods are stored as stringified blocks and 
compiled to code blocks when the object is 
restored, Information external to the object 
that is required to recreate the browse table 
will also be stored in the array, including 
the names of the DBF and index files, the 


#include "fileio.ch" 
#include "inkey.ch" 


local nHnd,; // File handle 


// Open or create save file: 
nHnd := OpenOrCreate (cFile) 
if nnd == F_ERROR 


return F_ERROR 
endif 


// Calculate data offset: 


function SaveArray(aArray, cName, cFile) 


nOff,; // File offset of array 
cOff // nOff as 4-byte int 


out ("Can’t open/create: " + cFile) 
q 


/* 


function Arr2String(aAr, cBuf) 


local nLen ,; // Number of elements 
a 1i // Array index 
cN +i // Number as a string 
cEtype,; // Element data type 


cBuf is passed back by reference in 
recursions & needs to be initialised 
on the first call: 


noOff := fseek(nHnd, 0, FS_END) + 16 
cOff := 12Bin(nOff) 


// Add jump table entry: 
nHnd := AddOff (nHnd, cName, cOff,cFile) 


// Convert array to string & append it: 
fwrite(nHnd, Arr2String(aArray) ) 
fclose (nHna) ‘ 


return 0 
function AddOff (nHnd, cArr, cOff, cFile) 


local cBuf := space(512),;// Buffer 
nThn ,i// Tmp file 
nByte // Bytes read 


// Create & open temporary file: 
nTnd := fcreate("TEMP", FC_NORMAL) 


// Write offset table entry: 
fwrite(nTnd, padr(cArr, 12) + cOff 


// Append the old file: 
fseek(nHnd, 0, FS_SET) 
do while (nByte := fread(nHnd, @cBuf,; 
512) > 0) 
fwrite(nTHnd, cBuf, nByte) 
enddo 


// Rename the new and re-open it: 
fclose (cTHnd) 

fclose (cHnd) 

ferase (cFile) 

frename ("TEMP", cFile) 

nHnd := fopen(cFile, FO_READWRITE) 
fseek(hnd, 0, FS_END) 

return niind 


/* 
Calculate number of elements in array 
& append type & length to buffer: 

kif 

nLen := len(aAr) 

cBuf += valtype(aAr) + i2bin(nLen) 


/* 
If the element is an array, recurse 
Otherwise, append its data type, then 
append its length & data if it is a 
simple data type (C, N, D or L). 

* 

ib 

for i := 1 to nLen 

cEtype := valtype(aAr[i]) 
iff cEtype $ "AO" 

Arr2String(aAr[i], @cBuf) 


else 
cBuf += cEtype 
do case 
case cEtype == "N" 
tmp := ltrim(str(aAr[i))) 
cBuf += i2bin(len(tmp)) + tmp 
case cEtype == "Cc" 
cBuf += i2bin(len(aAr[i])) + aAr[i] 
case cEtype == "D" 
cBuf += dtoc(aAr[i]) 
case cEtype == "L" 
eBuf += iif(aAr[i], "T", "L") 
endcase 
endif 
next 


return cBuf 


Figure 3 - Saving a multidimensional array 
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type of box that surrounds the table and the 
key-handler. 


In the key-handler in Figure 2, a CASE 
statement is used to determine the code run 
when a key is pressed. In Clipper, each key 
has an ‘inkey’ value - the integer returned 
by the inkey () function when that key 
is pressed. Inkey values can be positive or 
negative; for example the inkey value of the 
F10 key is -9, the value of the RETURN key 
is 13. We could write a more flexible ver- 
sion of the key handler by creating a two- 
dimensional array of code blocks, the first 
dimension representing positive inkey 
values and the second negative values. 


When a key is pressed we look it up in the 
array and evaluate the appropriate code 
block. If we need to change the action of 
an existing key, or define a new key to 
perform a new action we can construct a 
code block and assign it to the appropriate 
element in the array - the key handler will 
do the rest. 


To go one step further, we could store 
stringified blocks in the array instead of 
blocks; that way we could store the key 
handler methods off-line with the object. 


In recognition of the need for an object to 
be able to carry around more than the pre- 
defined instances and methods, Nantucket 
has provided each class with a cargo slot 
that can have any data type written to it. The 
cargo may hold simple data, a code block, 
another object or even a multi-dimensional 
array. 


Figure 4 shows code that illustrates the new 

ey handler and the use of the cargo slot to 
store miscellaneous data. The key handler 
methods array contains stringified code 
blocks which are ‘compiled’ within the key 
handler. In a ‘production’ version the con- 
tents of the array would be pre-compiled 
outside the key handler for speed. 


nthe case of a TBrowseDB object we can 
accept the default cursor movement meth- 
ods created for us when we re-instantiate 
the object for the DBF concerned - we do 
not need to save them in the array. The code 
block that determines the contents of each 
column is another matter; we do need to 
save a stringified version of this, for which 
we can use the cargo slot in the TBcol- 
umn in question. 


It is now possible to write a pair of conver- 
sion functions that map a TBrowse object 
to an array and vice-versa, The array pro- 
duced contains only simple data types and 
can be safely saved and restored to and 
from a disk file. 


User configurable TBrowse 


With the ability to 
TBrowse objects off 


store and retrieve 
“line instead of hay- 


ing to write code to recreate them afresh 


each time, we can rea 
gram to let users con 


istically tackle a pro- 
figure and save their 


own browse tables. With a little extra effort 
we might even be able to extend the con- 
cept to provide a powerful development 
tool - after all, methods can be im- 
plemented using stringified blocks, strings 
can be entered with a text editor and the 
syntax rules for code blocks are fairly 
straightforward... 


The key handler methods array can be ex- 
tended to include a second dimension for 
function keys, which can evaluate code 
blocks that manipulate the browse table 


Browsing with Clipper 


itself. For example, a function can be writ- 
ten to allow the user to re-size and/or move 
the browse table on the screen. The func- 
tion can be ‘attached’ to a function key by 
assigning an appropriate stringified block 
to the correct element in the methods array. 
As the user moves the table the appropriate 
instance variables are updated so that when 
the browse is saved the new co-ordinates 
are saved with it. 


By building on these concepts, a dynami- 
cally configurable browse table can be con- 
structed that allows the user to change 
almost anything, including the number, 
contents, titles, formatting and order of col- 
umns. With a little extra work an editor for 
changing stringified blocks can be devised 
and the key handler methods array updated 
on-line, 


Put an end to software piracy! 
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The keys are transparent and won't 
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to make back up copies, Normal node 
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Conclusion 


Familiarity with all of Clipper 5.01’s features 
and a modular approach to development 
can lead toa very high degree of reusability. 


The concepts behind the code presented 
here can be applied to construct a set of 
tools that the developer, or even the end- 
user, can use to build an application. Appli- 
cations built in this manner are easily 


#include “inkey.ch" 
#include "box.ch" 


ofb:addcolumn (tbcolumnnew (cField, ; 
fieldblock (cField))) 


Browsing with Clipper 


maintainable and can be enhanced or ex- 
tended easily. In addition, the quality of a 
system built out of tried and tested compo- 
nents is much higher, reducing mainten- 
ance overheads. The price, of course, is 
increased up-front development. There is 
often an overhead involved in modular de- 
sign; do you hard code the report or write 


next 
// tbho:cargo array contents: 
#define TB_DBF // .DBF File name cls 
#define TB_NTX 
define TB_BOX 
#define TB METH 
#define TB SLOT 


// .NTX File name 
// Box characters 
// Methods array 
// Free slot 


do while (nkp 


Oewnn 


sand, (nKp 


return NIL 
use (cDbf) index (cNtx) 
oTb := tbrowsedb(02, 10, 23, 70) function methods () 
// Initialise methods array: 
aMethods := methods () 


// Set up cargo slot to save info: 
:= array (TB_SLOT) 
reargo(TB FILE) := cDbf 


local aMet (40) 


aMet (K_RIGHT] 


aMet [K_PGUP] 
for i := 1 to fcount() 


cField := fieldname(i) return aMet 


@ 01, 09, 24, 71 box ofb:cargo[TB_BOX) 
r= inkey()) <> K_ESC 

do while ((! oTB:stabilize()) 

:= inkey()) == 0) 


// Key array is of stringified blocks 
// so it can be saved to a disk file: 


Ib] brright())" 


"{!b| b:pageup()}" 


an ad-hoc report generator? Commercial 
reality usually prevents increasing the cost 
of the current development to save on fu- 
ture systems, and code is continuously re- 


function aNewTbo(cbbf, cNtx) te nkp < len(aMethods) .and. nkp > 0 written from system to system. 
if valtype(aMethods(nkp}]) == "Cc" 
atc Hae eaeerace mre nama aNe SHece LOND Dir SIP) Perhaps the greatest single advantage of 
eMeEngasy Hy MebieusL sea ate OOP is that it forces the developer to adopt 
nkp // Key pressed a modular approach, but you have the op- 


tion to adopt this approach anyway, you 
don’t have to wait for OOP. 


EXE 


:cargo([TB_INDEX] := cNtx aMet (K_LEFT) Ib] b:left()}" yyy ic y _ Yr of Ah- 
Bae cate TETEOM| B SINGLE Sus icUE) Ibl biep 0)" James Or mrod is a founder member of Ap 
olbicargo(TB METH) := aMethods aMet (K DOWN) "(|b | bsdown() }" plications Technology Ltd, a Nantucket 
oTb:cargo[TB_ SLOT) := NIL aMet [K_PGDN] "{ |b] b:pagedown () }" 


Authorised Training and Development 
Centre. He is actively developing in 5.01 
and wishes somebody would properly docu- 


Figure 4 - Key handler with methods array 
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BRENT ‘Communications and Telemetry Consultants 
BEWARE THE PIRATE’S PATCH 


You sell your software. You 
don't give it away. It needs the 
kind of protection that only 
a top quality 
UN-PATCHABLE c 
dongle affords, but ( on 
you don’t want to = 
pay the Earth for it, 
and you want to be 
sure that you'll not 
be making mistakes 
in incorporating it into 
your code. 


The MAXPRO system is for you. There are 
microprocessor based units at realisitc prices which take 
care of complete .EXE files without access to source code. 
Set stop dates, tamper detection and many other facilities 
on a menu-driven front end. Encrypt in just moments. 
MAXPRO even copes with such as Clipper, QB & Clarion 
files with internal overlays. Neat trick. 


For additional information 
contact us at 


Brent Communications 
Unit 2 

Dragon Industrial Estate 
Harrogate HG1 5DN 

Tel: (0423) 566972 
Fax: (0423) 501442 


Eyeing up some FRACTALS? 
Puzzling over PETZOLD? 
Giggling over GUIs? 
Doodling with DDE? 


Check out London’s new specialist 
PC bookshop. More than 2,000 new 
books in stock; plus videos, selected 

magazines and software. Mail order 
service. Major credit cards accepted. 

Subject booklists always available. 


The PC BookShop 
21 Sicilian Avenue 
Southampton Row 
London WC1A 2QH 
Tel: 071-831 0022 
Fax: 071-831 0443 


OPEN MON-ERI 9.30-6.00 — SAT 10.00-12.30 


CIRCLE NO. 447 


CIRCLE NO.448 


.EXE Magazine, Vol 6, Issue 8, February 1992 


21 


t= ener Z+/ 


Nantuck 


Nantucket Tools II 


The Clipper world is particularly rich in third party add-ons. 
However, Bob Rimmington bas been looking at a new library from Nantucket itself. 


The main contenders in the xBASE market 
have their particular merits and their prota- 
gonists, However it is not always sufficient 
to compare basic packages, as the extent to 
which a system can be supplemented and 
enhanced with supporting software may be 
more relevant. Clipper is especially strong 
in this respect, with a wide range of add-on 
packages. Now Nantucket, the company 
behind Clipper, has itself released a much 
extended toolkit function library. 


Over 560 functions are provided. The types 
and numbers per category are set out in 
Figure 1. The toolkit is aimed squarely at 
Clipper v5.01, although most functions are 
said to work with the Summer ’87 version 
as well. They are all included ina single .LIB 
file though some categories also require a 
supplied Extended Driver .OBJ file to be 
linked in. Various documentation, exam- 
ples, font designer and other supporting 
files are also included. Installation is similar 
to Clipper itself, decompressing from the 
three (720 KB) distribution floppies onto 
the hard disc. 


New Categories 


Four categories are completely new to 
Tools II. For networks, just seven functions 
apply to PC LAN/MS-NET products, the re- 
maining 37 to Novell. All of the latter sup- 
port Netware 2.1 upwards and ELS II but 
not necessarily earlier versions or ELSI, The 
possible implementations are clearly indi- 
cated for each function. If you know your 
Novell you can access it via the Clipper RUN 
command, but Tools II not only makes 
things much easier but allows return values 
to be used and tested. LOGIN information 
such as IDs, rights and privileges can be 
obtained. Files can be copied and purged, 
the maximum and the free capacity of a 
Volume can be pre-checked in respect of 
both files and space. For printing, the 
Novell CAPTURE mode can be set, tested, 
activated and deactivated. Just one 
example, NNETCAPSSF (1, FALSE, 
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TRUE, 0, 5, 8, 2) will specify device 
LPT1, set an end-of-run form feed, print 
banner page, select server printer No. 0, set 
a five second time out, set tab width to 8 
and print two copies. 


The second new category, maths, contains 
a mixture of trigonometric and financial 
functions. A third, Peek/Poke, enables di- 
rect reading and writing of bytes and 16-bit 
words to memory and designated ports, It 
is rightly accompanied by dire warnings of 
use by anyone who does not fully under- 
stand the possible consequences. 


Tools II was originally written in German, 
and the translation to English has resulted 
ina few quirks. Not the grammar or style of 
any text, that is fine, but rather the occa- 
sional nonsense. For example, the intro- 
duction to the fourth new category, 
Get/Read functions, says it has been ‘re- 
tained’ for the sake of compatibility. GET- 
FIELDCOL() and GETFIELDROW () 

return the column and row start positions 
of a GET, useful if you need to write to that 
position froma VALID UDF function. There 
is a GETSECRET() function that sub- 
stitutes asterisks (*) for characters actually 
entered, Finally four functions for saving 
current GETs and SET KEY. . TO settings 
to arrays and for restoring them. These en- 
able new GET masks or key settings to be 
activated without losing the current ones. 


Windows and Extended 
Drivers 


The category that will first attract most new 
users is that for Windows. Let us get one 
thing straight from the start, this has nothing 
atall to do with Microsoft Windows. Instead 
it is a facility to place normal Clipper 
input/output in screen ‘Windows’ that can 
be moved, re-sized and overlapped by 
either the programmer or the user. For the 
latter, SCROLL LOCK must be activated and 
then the cursor keys act as one might ex- 
pect. There is no Mouse option though this 


may be possible through one of the third 
party add-ons. 


At the simplest level, the windows func- 
tions do little more than could be achieved 
by saving a screen area, writing to it and 
then restoring. However they do automat- 
ically replace both the content and colour 
attributes of all areas overwritten. The first 
plus comes with the positioning of output 
with @ SAY and similar statements. The 
codrdinates apply to the window, not the 
screen. So a window can be repositioned to 
suit a client with no more than a change to 
the WOPEN() parameters. The second 
comes with the ability to alternate between 
up to 255 windows (memory permitting) 
and to write to the currently selected win- 
dow. 


Extended Driver functions in part support 
Windows operations, in part act on a nor- 
mal screen. DSETWINDOW () enables the 
output of any external programs, such as 
DOS, to be confined to the current window. 
It is possible to address a virtual screen of 
up to 255 columns or 255 rows. There is a 
32 KB memory limit, so a typical maximum 
combination would be 255 columns and 


Figure 1 - Functions sby ee 


“What will happen to dBASE?" 
“When can | compile my dBASE code?" 
"Will | have to learn Paradox?" 

“How can | learn OOP at my own pace?" 
“What will the next version of dBASE be like?" 
"Will | have to learn another language?" 
“Where's the professional compiler?" 

"X" what?" 


"Will there be a next version of dBASE?" 


Nantucket 


Nantucket UK Ltd, 8 Bridgegate Centre, Welwyn Garden City, Herts. AL7 1JG. Nantucket logo and Clipper are trademarks of the Nantucket Corporation. Other brand 
and product names are used for identification purposes only and may be trademarks or registered trademarks of their respective owners. © 1991 Nantucket UK Ltd. 
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128 rows. The screen then becomes a view 
into a far larger area. The size of a virtual 
screen is defined with SETMAXCOL () 
and SETMAXROW () functions. For xBASE 
programmers, after years of working to a 
limit of 25 rows and 80 columns, it seems 
uncanny to be able to put @ 111,222 
SAY ... etc into a program. It does work 
though. An immediate use for this is where 
a normal entry screen is just not able to 
accommodate all the required GETs but 
paging to second or third screens is not 
ideal. The GET’ just scroll up as those at the 
foot of the screen are entered, the up-cursor 
will bring back those at the top. Simple to 
program, simple to use. See Figure 2. 


co 

DSETQFILE () enables the writing of a 
‘Quit’ file, comprising the current keyboard 
buffer, on any form of exit. An ideal way of 
checking for a normal exit or tracing the 
cause of a program failure. EGA43(), 
VGA (28) and VGA (50) allow alterna- 
tive screen modes. GETKXCLAT(), 
GETKXTAB () , INKEYTRAP () , SETKX- 


LAT(), SETKXTAB(), TRAPANY- 
KEY () and TRAPSHIFT () allow sophis- 
ticated key trapping and action. INKEY () 
will never be the same again. KEYSEND () 
and KEYREAD () extend the use of the 
keyboard buffer. 


External Devices 


The Serial Communications category will 
not excite every Clipper developer but 
could prove invaluable to some. Among 
new functions for Tools II are XMO- 
BLOCK () and XMOCHECK (), to gener- 
ate and test X-MODEM blocks. For printing 
there are functions to check ports and prin- 
ters, print the screen (very handy when 
logging application errors) and make vari- 
ous use of the DOS PRINT facility. 


Many applications require access to drives 
or to do more than USE and INDEX files 
within the normal xBASE language. Such 
activities work through DOS and so make 
the application vulnerable to normally un- 


Nantucket Tools I 


trappable DOS errors. This can be a particu- 
lar problem where the operator has to use 
a floppy drive for backup or similar tasks. 
The scope of the Disk Utilities category is 
now so wide that it is difficult to think of a 
circumstance it does not cover. DIS- 
KREADY () will check thata drive contains 
adisk and isready touse. DISKREADYW () 

will check that it is not write protected. 
DISKFORMAT () willallow, through UDFs, 
both easier selection of format modes and 
control of format track repeats. Other func- 
tions allow interrogation and control of 
available disk space in relation to file sizes. 


A complete sequential backup using a set 
of disks is possible with safety checks at 
every stage, FILESEEK () can be called 
with parameters to find the first matching 
file, then repeatedly called without parame- 
ters to find each subsequent file. Any de- 
veloper who has found the combination o 
users and floppy disks a potential hazard 
would find this category alone well worth 
the money. 


/* NANTUCKET TOOLS II - EXAMPLE CODE 


. Position text relative to border 
@ WEROW (TRUE) +1, WFCOL(TRUE)+1 SAY ‘This is Window No. 3/ 
INKEY (0) 


/* Now back to normal screen with original text restored */ 


/* Define virtual screen, write text to right of and below 
physical screen. Move about virtual screen with cursor keys 
in conjunction with INKEY(), DO WHILE loop and DO CASE test. 


/* 


If GETs are used, normal navigation with cursor keys causes 
physical screen to show relevant portion of virtual screen 


The code below illustrates Tools functions for */ 

Windows and for a Virtual Screen, Both require the 

Extended Driver file NT2US50.0BJ to be linked in. SETMAXCOL (121) //.++ Set number of columns 
*/ SETMAXROW (51) //.++ Set number of rows 
#include ‘INKEY.CH’ //... Include constants for key @ 0,0 CLEAR TO 51,121 . Clear (text etc. may remain 
codes in unseen screen area) 
define TRUE @ 3,1 SAY ‘Left of screen’ Write across virtual screen 
fdefine FALSE .F. @ 3,35 SAY ‘From column 35’ 

@ 3,65 SAY ‘From column 65’ 

LOCAL nWinNum1, nWinNum2, nWinNum3,nkey:=0,nCtr @ 3,99 SAY ‘From column 99/ 
/* Open three Windows, Write text to them, Select, FOR nCtr=5 T0 51 STEP 2 //.s. Write down virtual screen 

move and close Windows, Pause using INKEY (0) @ nctr,5 SAY ‘This is row /+NTOC(nCtr) 
cif NEXT 
CLs @ 0,0 say’! //... Return to top left 
@ 12,30 SAY ‘This is normal screen’ * 
* DO WHILE nKey !=27 //...+ Loop until Esc pressed 
WSETSHADOW ('W/BG! ) //... Transparent shadows * 
niinNum1=WOPEN (5, 5,15, 50) //... Open first window nkey :=INKEY (0) //... Read cursor keys with 
WBOX () //... Draw default box round it INKEY () 
@ 2,2 SAY ‘This is Window No. 1’ * 
INKEY (0) DO CASE 
nWinNum2=WOPEN (10,25, 20, 60) //.++ Open second window CASE nKey=K_UP 
WBOX () FIRSTROW (FIRSTROW () ~1) //... Reset first row of screen 
@ 2,2 SAY ‘This is Window No, 2/ CASE nKey=K_DOWN 
INKEY (0) Re FIRSTROW (FIRSTROW () +1) 
nWinNum3=WOPEN (15, 35, 22,75) //... Open third window CASE nKey=K_PGUP 


FIRSTROW (FIRSTROW () -10) 
CASE nKey=K_PGDN 

FIRSTROW (FIRSTROW () +10) 
CASE nKey=K_LEFT 


//... Select first window, this brings it to the top FIRSTCOL (FIRSTCOL ()~-1) //... Reset first column of screen 
WSELECT (nWinNum1) CASE nKey=K_RIGHT 

INKEY (0) FIRSTCOL (FIRSTCOL () +1) 

WMOVE (WROW () -3, WCOL () ~3) //... Move up and to left CASE nKey=K_CTRL_LEFT 

@ 4,2 SAY ‘Now moved towards top left’ FIRSTCOL (FIRSTCOL () -10) 

INKEY (0) CASE nKey=K_CTRL_RIGHT 

WCENTER (TRUE) //... Move to centre of screen FIRSTCOL (FIRSTCOL () +10) 

@ 6,2 SAY ‘Now centred on screen’ CASE nkey=K_ESC 

INKEY (0) EXIT 

* ENDCASE 

WCLOSE () //... Close current window (1) iy 

INKEY (0) ENDDO 

WCLOSE () //... Close current window (3) i 

INKEY (0) @ 0,0 CLEAR TO 51,121 //... Brase everything 

WCLOSE () //.++ Close remaining window (2) FIRSTCOL (0) //... Reset for normal physical 
INKEY (0) screen 


FIRSTROW (0) 
* 


RETURN 


EOF Demo program */ 


Figure 2 - Example code for Windows and Virtual Screens 
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¢: Creating temporary 


swap file, please wait. 


How much longer can you afford to wait? 


Create Overlaid Programs-Fast. 
BLINKER"™, the world's first and 
fastest dynamic overlay linker, 
reduces your link time to seconds 
and reduces program memory 
requirements. Now you can use 
one linker for all your software 
projects. 


One Linker, Many Languages. 
BLINKER 2.0 links and automati- 
cally overlays DOS programs 
written in Microsoft?C, BASIC, 
Assembler, QuickBASIC”, 
Fortran, Pascal, Watcom” C, 
Zortech C++, Clipper, FORCE® 
and in Borland’ C, C++, 
Assembler, and more. 


Save Time and Memory. 
BLINKER removes the need for 
overlay structures, simplifies 
program design and reduces 
memory requirements to save 
you time, effort and memory. 


Memory Swap Function. 
BLINKER is the ONLY linker to 
offer an integrated memory swap 
function, so you can run other 
large programs from within your 
program, with negligible memory 
overhead. 


BLINKER 


High Performance Qynamic Overlay Linker 


Don't Settle for Less. 


Other major features include full 
CodeView? support, use of 
EMS/XMS at program run-time, 
and enhanced execution speed 
of overlaid code. 


Time is Money. 

BLINKER offers all this in a frac- 
tion of the time it takes to link 
with your current overlay linker. 
You know time is money, and link 
time is no exception. 


Free Demo 

To try our free demo 
on your own code 
and for more information 
contact our U.K. distributor: 


Call: +44-81-994-4842 
FAX: +44-81-994-3441 


QBS Software Ltd. 

10, Barley Mow Passage 
London W4 4PH 

BLINKER is 

available in 

5.25" of 35" 

diskette format 

Price £199 Blinkinc 
plus shipping & handling P.O. Box 7154 
(zzz) (CB), Ree 


© 199) Blinkinc. Blinker is a traclernark of Assembler Software Manufacturers Inc. 
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Strings and Numbers 


Attempting to illustrate the many string 
functions risks becoming just a boring cata- 
logue. Some seem quite obscure at first, 
then a need arises and their value is ap- 
preciated, REMALL () ,REMLEFT () and 
REMRIGHT() are like ALLTRIM(), 
LTRIM() and RTRIM() except that in- 
stead of just blanks any specified characters 
can be removed, Ever needed to remove 
trailing ‘0’s from a number? Try 


REMRIGHT (cMemvar, ’ 0’) 


Many other functions allow selection and 
manipulation of characters within strings. 
CHARSORT () allows sets of characters to 
be sorted within a string with parameters to 
set the length of the sorting element, offsets 
and other options. 


Three functions enhance the use of others. 
CSETREF (), if called with TRUE, sup- 
presses a return value. When used with a 
long string passed by reference it avoids 
wastage of memory on a duplicate string. 
CSETATMUPA (), if called with TRUE, 
sets a multi-pass mode on for functions 
such as ATREPL () (search fora sequence 
within a string and replace it) and 
NUMAT () (count the occurrences of a se- 
quence in a string). SETATLIKE () en- 
ables wildcards to be used in AT... () 
and similar functions. 


A group of ‘Token’ functions can be used 
to identify words, sentences, dates and other 
sets of characters within a string. A ‘Token’ 
is a sequence of characters within delimi- 
ters. These could be spaces and all the 
normal punctuation symbols to identify 
words. In this context a word could have a 
different delimiter at each end such as a 
space before and a comma after), Typical 
uses for the token functions include neat 
word-wrapping of long text fields in a re- 
port and fast text searches. For the latter, 
words in a text field could be extracted, saved 
(with a record ID) in a separate indexed file 
and then found with the SEEK command, 


’ 


The Numbet/Bit category allows conver- 
sion of numbers to a different base and 
various binary operations such as AND, OR, 
XOR and NOT. Other functions include two 
for random numbers and another to convert 
floating point numbers to 8-byte strings. 


Other Categories 


A further 184 functions are in the six ca- 
tegories not already mentioned. Space per- 
mits mention of only a few samples. 
NTOCDOW () and NTOCMONTH () change 
week and month numbers into names. 
SHOWKEY () enables screen display of the 


status of the NUM-LOCK, SCROLL-LOCK, 
CAPS-LOCK and INSERT keys. ENV- 
PARAM () reads the DOS environment 
into a string. 


LL deeedeeeeeeeeeeeceeeeedeedeeededddeeededdd 


If you find the 
combination of 


users and floppy 
disks a hazard, 


then these 
functions are well 
worth the money 


UMMM 
The Video category include alternate fonts 
and palettes while Miscellaneous includes 
sound, Some example files are supplied for 
the latter. For the client who has everything, 
how about a message in Cyrillic script as the 
screen slowly fades from one shade to an- 
other? Or a computer rendition of the Moon- 
ight Sonata in the background? Perhaps not 
but, if he does insist, it is now possible. 
SCREENWRITE () writes a screen to a 
ile, FILESCREEN() will read it back 
again. Functions such as CLEARSLOW () 
and SAYMOVEIN () allow visual effects, 
similarly GETBOXGROW () for a control- 
led box explosion. 


Documentation 


The toolkit in part extends the scope of 
Clipper itself, in part provides an off-the- 
shelf and faster alternative to routines a 
programmer could write for himself. If the 
potential saving in development time is to 
be realised good documentation is essen- 
tial. Nantucket scores high marks with its 
main reference material. Every function is 
fully described, with brief examples, ina set 
of three clear, ring-bound manuals. The 
same information is repeated in a data file 
for use with the Norton Engine supplied 
with Clipper itself. The latter is good pro- 
viding you know the relevant category, as 
this must be selected first. It is a pity that no 
overall search facility is included for those 
occasions where the precise syntax for a 
known function name is required. 


Unusually, what seems to be the same data 
is supplied in a third format in a text retrie- 
val system. This will search for all entered 
strings, including wild cards. Although I 
commend Nantucket’s intentions, I have to 


mummy £07 


Ne ket Tools II 


confess that I have found it of little value. It 
is not a TSR and so is not easily accessed 
while writing code. Nor does it tell me 
anything fresh. Sorry Nantucket, perhaps 
the penny will suddenly drop one day. A 
surprising omission is any instruction on 
how to start it though few will fail to try the 
obvious solution of just entering the name 
of the .EXE file. 


Less satisfactory is the limited provision of 
‘how to use it all’ guidance. There are some 
example program files, enough to prove 
how valuable these can be, too few to cover 
most functions. Query By Example is very 
much flavour of the month for users, why 
not Program By Example for developers? 
Many would find this more beneficial than 
three versions of the formal instructions, 
The example programs include only mini- 
mal and often inadequate comment. Not all 
use the current Nantucket convention for 
naming variables. Except for the examples, 
no source code is supplied. 


Performance 


All the functions tried worked without prob- 
lem, Tools II includes a ‘two screen’ Debug 
facility for those with both VGA and Her- 
cules cards in their machines and of course 
the corresponding monitors, It was not 
possible to try this (the /S switch used with 
CLD gives a comparable facility on one 
screen using the 50 line VGA mode) but 
with several functions calling the debugger 
did seem to cause some problems. Use of 
Blinker in place of RTLINK seemed ok, but 
only if the Tools II .LIB and .OBJ files were 
not placed in the overlay area. 


Conclusion 


Many of the Tools II functions open up 
areas not previously accessible to Clipper 
developers. With others, users will save 
much of the time spent building their own 
personal library. For the latter purpose 
alone saving just two days would make it 
self-financing. Few will find a need for all 
565 functions. However it is the benefit 
from those that are used that matters, The 
Toolkit is comprehensive, well presented 
and, notwithstanding the small reservations, 
is well documented. It is the availability of 
additional products of this quality that help 
make Clipper the preferred choice of many 
xBASE developers. 


EXE! 


Bob Rimmington is an independent xBASE 
and Clipper consultant. He can be con- 
tacted through Stanford Systems on 0444 
236352. Nantucket Tools II is priced at 
£495. Nantucket is on 0707 373600. 
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Clipper PLLs 


Using Pre-Link Libraries 


Interested in linking your applications more quickly and decreasing your disk space usage? 
Aric Rosenbaum explains how Clipper’s PLLs can accomplish all of this and more. 


With the introduction of Pocket Soft’s 
.RTLink, a new method of linking has ar- 
rived on the Clipper scene. More specifi- 
cally, we are talking about run time or 
pre-link libraries, Since Nantucket includes 
a copy of .RTLink with every copy of Clip- 
per 5.0, this feature is available to every 5.0 
user, This article will explain what pre-link 
libraries are and why they should be used. 
In addition, the usage and creation of pre- 
link libraries will be explored. 


Background 


Pre-link libraries (PLLs) provide a core of 
routines that are common to various dif- 
ferent applications. They do not need to 
be compiled and linked every time an 
application is created. In addition, all of 
your Clipper programs can rely on one pre- 
link library. This significantly reduces link 
times, disk space, and modem transfer 
times. 


For instance, it is almost a certainty that 
every one of your Clipper applications has 
a function that will centre a string on the 
screen. This is one of the many dozens of 
functions that developers think nothing 
about including in an executable. How- 
ever, every time you create a new version 
of your program, you must compile and 
link the centre function. If you are truly 
organised and have placed the centre 
function in a library, you only need to 
deal with the time consuming linking. 
This is wasteful. Why not compile and 
ink the function once? The code does not 
change. In addition, this code could be 


used as part of a common code bank for all 
your applications. 


Pre-link libraries do just this. Instead of 
linking all you routines into a giant .EXE file 
(of the type for which Clipper is justly no- 
torious), you create a smaller .EXE and sup- 
ply aseparate .PLL file. When your program 
is run, special code loads up the .PLL so that 
it can use the library functions, The reduc- 
tion in disk space is achieved by having 
several applications share the same PLL. 


Using .RTLink, you instruct the linker to 
create your own pre-link library. When 
linking an application, you inform the lin- 
ker that you will be using a pre-link library, 
When the application is executed, the pro- 
gram will load and use the pre-link library. 


Benefits 


As I have hinted, the benefits of PLLs are 
substantial. They include decreased link 
times, decreased disk space and decreased 
modem transfer times. To illustrate the above 
three conclusions, two applications were 
tested. The first is a very short program that 
uses some of Clipper’s features, This pro- 
gram, shown in Figure 1, utilises commands 
and features such as: SKIP, eof (), SAY, 
and GET. Using a one line program that 
says, ‘Hello World’ does not properly con- 
vey why Clipper is used. Since real life 
applications rarely work like test programs, 
I also compare a Summer ’87 program that 
was recently converted to 5.0. In summary, 
linking times were as much as 4.8 times 
faster and applications were as much as 


32.8 times smaller. Imagine a Clipper EXE 
file that takes up as little as 7168 bytes of 
disk space! However, please note that I did 
not say that the executable was 7 KB. The 
executable still requires a 277 KB PLL, 


If your clients are supported by modems 
and you routinely transfer new versions, 
these small executables are of interest. For 
example, instead of spending 16 minutes 
transferring an executable with a modem, 
you could spend 30 seconds. This enhances 
your ability to get your client back on-line 
as quickly as possible and keeps your 
money out of the telephone company’s 
pockets. 


Now, after all these fantastic claims, I am 
sure a few cynics exist. You might be 
saying, ‘Oh sure, And dol get a free pair of 
Ginsui steak knives.’ Well, I cannot promise 
the steak knives, but the claims are true. 
Figures 2 and 3 show the results for the 
small test program. 


These are pretty impressive numbers, All of 
this with the pre-link library that ships with 
Clipper 5.0. This pre-link library includes 
CLIPPER.LIB, EXTEND.LIB, TERMINAL.LIB, 
and DBFNTX.LIB. While the raw results for 
the real-life applications are not as awe-in- 
spiring, they are still very credible. These 
results can be seen in Figures 4 and 5. 


Again, the above numbers are based upon 
using Nantucket’s BASES0.PLL pre-link li- 
brary. By pre-linking the common libraries 
that I normally use, even better results can 
be obtained. 


CLOSE DATABASES 

CLEAR SCREEN 

USE test_dbf INDEX test_ntx ALIAS 
GO TOP 


DO WHILE 
SKIP 
ENDDO 


«not. eof () 


sample := space(10) 
test NEW @ 10,10 SAY ‘Anything: 

READ 

? sample 

RETURN 


’ GET sample VALID (.t.) 


Figure 1 - Source code for small test program 
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; 386-PROLOG 
File Edit Query Help 
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£1 PROLOG 


Yes, it's here! LPA 386-PROLOG is now 
available in a version for Windows! Just like 
the DOS-extender version, it is a genuine 
32-bit Prolog compiler which can directly 
access up to 4G (4096M) of memory. Only 
this time, it is fully integrated with the world’s 
most popular GUI: Windows 3! \ 


Logic Programming Associates Ltd 
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Data conversion 
Full artwork/origination service 
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SERVICE 


RIDGEWAY PRESS, 0734 845331 
FAX 0734 845186 
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LIANT C-scape® 3.2 


The latest release of C-scape — the best selling character/graphics 
based screen interface C library in the UK. Runtime royalty free. 
Includes Look and Feel™ Screen Designer and Source Code. Available 
for DOS, most DOS Extenders, UNIX, X Windows and VMS. 


DOS — £370 [incl source and LnF) 
UNIX — £1065 (incl source and LnF) 


OTHER LIANT PRODUCTS 


LPIC — ANSI standard C for UNIX £660 
— ANSI standard C for DOS £695 
LPIC++ — for UNIX £975 
LPI COBOL — for UNIX £950 
— for DOS £875 
LPI FORTRAN, — for UNIX £975 
— for DOS £875 
LPI PASCAL — for UNIX £950 
LPI — PL/I — for UNIX £2200 
— for DOS £1095 


Heron C-scape _— 
oftware Extension Library 


New version 2 


Enhanced set of functions for C-scape 3 Price 
Includes Source Code..... DOS £150 
Unix £250 


Phar Lap 386|DOS Extender™ 


Beat the 640K DOS limit with a flat 32-bit address space 
on 386 processors. Voted best of 1989. Supports a wide 
range of 32-bit languages. .....SDK £330 


Phar Lap 286|DOS Extender™ 


C beyond 640K with your Borland C++, Microsoft C or MS Fortran 
compiler on any 80286, 386 or 486 platform....SDK £330 


Raima Data Manager™ 
Release 3.21 


Complete family of C library dbms functions and database management 
utilities for DOS, Windows, OS/2, Macintosh, UNIX, QNX, VMS. 
Source code available — runtime royalty free. 
Single-user DOS, OS/2 or Windows DBMS object libraries..... 

From £460 
Ask for details of other options and multi-user pricing. 


MagnaCharter Il 


Enhanced version of the much acclaimed MagnaCharter charting 
package for Windows 3, 99x99 cells with wide range of printer 


support. Complete set of symbols — or add your own..... £160 
Still available, MagnaCharter for DOS (includes runtime 
Windows 2.)..... £NB 


NEW — intelligent free text organiser and 
text retrieval system. Complete personal 


"information manager or corporate 
information system. 
INFORMATION MANAGER DOSS/U £175 DOS M/U £625 


The only complete personal finance 
package — for DOS £149.95 
N 


IEW — Tax Reckoner for UK tax payers — 


ACCOUNTANT ‘2x 20s £119.95 


(Personal Accountant prices include VAT). 


az) 
Ns = ws 
All Systemstar products are distributed and supported 
by Systemstar. Prices are exclusive of VAT 
(except Personal Accountant) and subject to change. 
Orders and enquiries to: 


YSTEMSTAR 


1-3 Parliament Square, Hertford, SG14 1EX 
Telephone: (0992) 500919 Facsimile: (0992) 554261 
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Drawbacks 


As everything else in this world, there are 
drawbacks to using pre-link libraries. These 
problems, however, are minimal. The first 
disadvantage is that using pre-link libraries 
creates a larger load module. The size dif- 
ference varies with each application but is 
somewhere between 6 KB and 13 KB. With 
the introduction of VMM and dynamic over- 
lays, this small overhead does not present 
a problem. 


The second obstacle is more of a problem 
of logistics. What if the user, running Xtree 
after a heavy night on the glue, deletes the 
pre-link library? He will not only lose the 
application in the current directory but all 
the Clipper applications. This is regarded as 
the biggest detriment to pre-link libraries. 
For this reason, developers are leery of 
having multiple applications rely on one 
core. I, however, do not see this as a signi- 
ficant risk If you are really windy, marking 
the file as read-only 


ATTRIB +r MY_PLL.PLL 


will thwart all but the most determinedly 
suicidal users, 


Using PLLs 


Using pre-link libraries with your execu- 
table is so easy that I considered omitting 
this section. Nothing special needs to be 
added or changed in your executable. In 
addition, no special driver or TSR needs to 
be loaded before loading your application. 
When the linker links your application, it 
will properly inform the executable that it 
needs a pre-link library. 


When executing an application that re- 
quires a pre-link library, the program will 
look in one of two places for the library. 
The first, of course, is the current directory. 
Ifa pre-link library is specific to a particular 
application or only one Clipper application 
exists in the system, the library will prob- 
ably be placed in the same directory as the 
executable. However, if multiple applica- 
tions are using the same pre-link library and 
these applications reside in distinct direc- 
tories, a different approach needs to be 
taken. One approach is to place each appli- 
cation in its own directory and locate the 
pre-link library ina unique directory. When 
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Figure 2 ~ Raw results for the small test program 


Clipper PLLs 


smaller 


modem time 


Figure 3 - Comparative results for tbe small test program w 


w/ BASESO.PLL 


Size of REAL.EXE: 105,472 
Size of BASE50.PLL: 277,504 
Link time: 67.1 sec. 
Transfer time with 

a 2400 baud modem: 7.3 min. 


r (and less expensive). 


w/o PLL. 
343,040 
n/a 

159.1 sec. 


23.8 min. 


Figure 4 - Raw results for the real-life application 


an application is executed it will load the 
pre-link library from the other directory. To 
do this, you have to tell Clipper where the 
pre-link library resides. This is done with an 
environment variable: 


SET PLL=C:\PLL 


The above environment variable will tell 
the application to search the PLL subdirec- 
tory on the C; drive if the proper pre-link 
library cannot be found in the current direc- 
tory. If your pre-link libraries reside in dif- 
ferent places, you specify the locations and 
separate them with a semicolon. 


Linking with PLLs 
If you are planning to use a pre-link library 
with your application, you must inform the 
linker and tell it what pre-link library will 
be used. To inform the linker that pre-link 
libraries will be used, a command is in- 
serted in the link script file (ie .LNK file). If 
you are using the command line mode, you 
will need to use the ‘/PLL’ switch. If this 
command is not included, the linker will 
either link the normal library or complain 
about undefined symbols. It depends on 
what is missing, If the pre-link library is not 
specified, the linker will automatically link 
CLIPPER.LIB, EXTEND.LIB, TERMINAL.LIB 
and DBFNTX.LIB. However, if the pre-link 
library is not specified and the required 
function is custom, the linker will issue an 
undefined symbols warning. 


Specifying the pre-link library can be done 
in one of two ways. The first and most 
common is in the link script file. For 
example, when linking the test program, I 
used the following link script file: 


FILE TEST 
PLL BASESO 


Alternatively, if | issued the link command 
from the DOS prompt: 


RTLINK FILE TES /PLL:BASE50 


It really is no more difficult than including 
a normal library. 


Creating PLLs 
Creating pre-link libraries, while more dif- 
ficult, is almost as easy as using them, In 
summary, it requires: 


@ Informing the linker that you are crea- 
ting a pre-link library. 


© Specifying the object files and libraries 
to search, 


@ Referencing the modules that are to be 
included. 


The first step is accomplished by including 
the command word ‘PRELINK’ in your 
link script file. When the linker parses the 
script file, it will know that it should create 
a pre-link library instead of an executable. 


The second step is the same as the normal 
linking process. Specify the object code 
files and libraries that should be used to 
construct the pre-link library. For example, 
if we are using the following to build our 
pre-link library: 


Object files Libraries 
APP_OBJ1 COMM_LIB 
APP_OBJ2 MOUS LIB 
APP_OBJ3 SCR_LIB 


The link script file would look as follows: 


PRELINK 
OUTPUT MY_PLL 


FILE APP_OBJ1, APP_OBJ2, APP_OBJ3 
LIB COMM LIB, MOUS_LIB, SCR_LIB 
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Out with the Old 


Inwith -: 
— theNew | 


MagnaCharter Il 
relieves the pain | 
of drawing charts. ' 


\ Magnacharter 


MagnaCharter was one of the success stories of 1990. MagnaCharter II is the latest 
version of this much acclaimed product — for Microsoft Windows 3. Based on the 
spreadsheet principle, MagnaCharter II lets you build any kind of chart in minutes 
rather than hours and includes all the standard flowcharting symbols. Use the 


“crowsfeet” for database diagrams. 
MagnaCharter II divides the screen into cells, identified by a double mouse click or 
keyboard entry into which symbols are placed. All available symbols are displayed 


as icons — or add your own. The various features are accessed via drop 


j down menus, dialogue boxes and multiple windows with a wide 


range of text styles and sizes available. Editing is by simple cut- 
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It is important to note that the object code 
files that are listed contain common func- 
tions and procedures that we want to in- 
clude in our pre-link library. You do not list 
all the object code files that make up your 
application. 


An excellent way to illustrate the creation 
of a pre-link library is with a short analogy. 
Picture walking into a room full of books. 
You walk up to a stately oak table and sit 
down, Sitting in front of you is a completely 
empty table. Your project is to create a 
compilation of chapters from numerous 
books. Your first step of course is to get the 
books you need (object code files and li- 
braries) and place them on the table in front 
of you. This done, you must now tell your 
assistant (linker) what chapters to include 
in the compilation. You do this by referring 
to the chapters (modules) in question. 
Once referenced, your assistant will duti- 
fully copy the needed chapters into the 
compilation, After a minute or two (your 
assistant was a speedy, scholarly monk in a 
previous life), your compilation is complete 
and ready to be used by anyone who 
pleases. 


Now that we have specified the object code 
files and libraries to search, we need to tell 
the linker what modules to place in the 
pre-link library. This is done with the 
REFER command. Following the REFER 
command are all the modules that should 


iud modem time 


Figure 5 - Comparative resulls Sor the real-life application 


PRELINK 
OUTPUT BASESO 


LIB CLIPPER, 
REFER _main 
REFER _VOPS, 
REFER _VTERM, 
REFER _VDBG 


EXTEND, TERMINAL, 


_VMACRO, 
_VPICT, 


_VDB, 
_VGETSYS 


DBFNTX 


_VDBF, 


be included in the pre-link library. In our 
example COMM_LIB contains the follow- 
ing modules: 


dial() 
set_baud() 
set_parity () 
xfr_kermit () 
xfr_x() 
xfr_z() 


We only want to include dial () and 
set_baud() in our pre-link library. We 
can do this by adding the following lines to 
our link script file: 


REFER DIAL SET_BAUD 


The link script file now looks as follows: 


PRELINK 
OUTPUT MY_PLL 


FILE APP_OBJ1, APP_OBJ2, APP_OBJ3 
LIB COMM _LIB, MOUS_LIB, SCR_LIB 
REFER DIAL SET_BAUD 


Based upon the above link script file, 
MY_PLLPLL will contain two modules: dial 
and set_baud. Although we instructed 
it to search three object code files and two 
other libraries, only two modules were 
included, To include the modules in the 
other libraries, we would need to refer- 
ence them. 


One last note is that you should not worry 
about undefined symbols when creating a 


_VDBFNTX 


Figure 6 - BASE5O.PLL link script file 


PRELINK 
OUTPUT MY_PLL 
LIB CLIPPER, EXTEND, TERMINAL, 
FILE APP_OBJ1 APP_OBJ2 APP_OBJ3 
REFER _main 
REFER _VOPS, 
REFER _VTERM, 
REFER _VDBG 
REFER DIAL SET_BAUD 


VDB, 


_VMACRO, _' a 
“VGETSYS 


_VPICT, 


DBFNTX 
LIBRARY COMM_LIB MOUS_LIB SCR_LIB 


VDBF, _VDBFNTX 


Figure 7 - Revised My_Pll link script file 


Clipper PLLs 


pre-link library. This is only a warning 
message. The undefined symbols will nor- 
mally be resolved when the executable is 
linked. If, however, you receive an un- 
defined symbols warning when linking the 
application then it is possible that the pre- 
link library was not properly created. 


Creating BASE50.PLL 


As previously stated, Clipper 5.0 is shipped 
with BASESO.PLL, a compilation of CLIP- 
PER.LIB, EXTEND.LIB, TERMINAL.LIB and 
DBFNTX.LIB. If creating your own pre-link 
libraries is of no interest, you should, at a 
minimum, use BASESO.PLL. The code in 
this library will not, of course, change and 
you will experience quicker linking times. 
If you would like to re-create BASE5O.PLL, 
you can use the link script file that appears 
in Figure 6. 


A few important points should be made. 
First, the capitalisation of the references is 
critical, As explained, REFER is respon- 
sible for pulling in certain modules. Chang- 
ing lower-case to upper-case or vice versa 
will affect what modules are included in 
BASESO.PLL. 


Second, if you want to create your own 
pre-link library that includes the above li- 
braries, simply modify the link script file. 
All you need to do is change the output file 
name, include the appropriate libraries and 
object code files, and insert the correct ref- 
erences. For example, ifI wanted to include 
the Clipper libraries in MY_PLL.PLL, I 
would use the link script file that appears 
in Figure 7. 


Conclusion 


Pre-link libraries are a great benefit to 
anyone who develops with Clipper. They 
decrease link times, disk space, and 
modem transfer times. These three benefits 
far outweigh the two minor drawbacks of a 
slightly increased load size and modest in- 
crease in vulnerability to dopey users. After 
experimenting with pre-link libraries, I am 
pleasantly surprised and plan to incorpor- 
ate them into all of my future 5.0 applica- 
tions. 


EXE 


Aric Rosenbaum is President of AR Consult- 

ing, Inc. His firm, located near New York 

City, specialises in the creation of custom 
software for a growing list of local and 
global clients. Aric is very interested in your 
comments and can be reached in the US on 

0101 201 301 0909 (telephone), 0101 201 

301 0128 (fax) or on CompuServe us 
72460,1177. 

33 


.EXE Magazine, Vol 6, Issue 8, February 1992 


Microsoft C/C++ 7.0 


Great Expectations 


Le Compiler Nouveau est arrivé! Paul Kemp bas been poring over a pre-release copy 
of Microsoft C/C++ version 7.0 - the world’s most long-awaited compiler. 


No one can accuse Microsoft of a headlong 
rush to OOP, The compiler giant has been 
quietly biding its time while its competitors 
push out new versions of their C/C++ com- 
pilers with evangelical zeal. Microsoft C/C++ 


7.0 (C/C++7) has been a long time coming 
but it represents a colossal upgrade. To 
merely bump up the version number from 
6.0 to 7.0 seems almost self-deprecating on 
the part of the company. I must stress that 


Window Class Hierarchy 


CObject 
coc CaDIOrjoct Wad CWinApp 
poo 
Cetientoc Pen CFramoWnd ha cstatic. 
lcwindowoo} Brush CButor 
cPaintoc Font ‘CMOIChiKEWnd cea 
Bitmap |CMOIFramoWnd ListBox 
CPalotto ComboBox 
‘cRgn CScrolBar 
L- (non-window classes) 


General Purpose Class Hierarchy 


Cobject 
ea ei re a 
Exception cre ClisteTypo> CMapeKEY, VALUE> CArray<Typo> 
CSidloFie Pitt +} CMapWordToob TH} ceytoArray 
‘CMomFilo CobList F] CMapworsTortr TH] cwordarray 
Archi cStingList FH] CMapPirToword FH] cowordArray 
‘CDumpContext sting fF] CMapPtrtoPir Ho oPwAray 
CTimoSpan TH CMapstiingToPtr FH CObAray 
FH, cMomoryexcoption Timo F-] CMapstringToob LY cstringaray 
1} CFloexcoption “}cMapStringToStving 
1} CArchivotxcoption Rect CMomoryStato 
FF] CNotSupportedéxception Point (CRunTimeCla 
H CResourceExcoption csize OF Stat (window classes) — 
1) coleexception 


Figure 1 - Microsoft Foundation Classes (MFC) hierarchy 
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this article is very much a ‘first impressions’ 
overview of the product, There are two 
reasons for this: One, at the time of writing, 
the product was still at a beta V5.0 (called 
‘Pete’ after Pete Best the Beatle - previous 
betas were named ‘John’, ‘Paul’, ‘George’ 
and ‘Ringo’). It would therefore be unwise 
and unfair to benchmark the compiler and 
IDE properly. Two, we plan to do an in- 
depth analysis of the product in a future 
issue of .EXE. This will probably be when 
the next release of the compiler (probably 
v7.1) is available. 


The basics 


C/C++7 is a 32-bit protected mode C and 
C++ (v2.1) compiler, although as yet it does 
not support the creation of 32-bit DOS or 
Windows applications (this will be rectified 
in the next release). Microsoft has dropped 
support for low-end development machines 
altogether and the product requires an 80386 
processor (or higher) and at least 4 MB 
RAM. The compiler, linker and PWB are 
DPMI-hosted under DOS, or can be run in 
a DOS box under Windows. In another 
controversial move, all support for OS/2 
has been withdrawn. Such action is surely 
counter-productive when other software 
vendors are breaking their backs to provide 
cross-platform support for their products. 
However, Microsoft UK Head of Languages, 
Andrew King, did indicate that there is a 
good chance of the compiler supporting 
OS/2 v2.0 in a future incarnation. 


The basic Windows SDK has disappeared 
(at last) and all the necessary tools for de- 
veloping Windows apps (Dialog Editor, 
Font Editor, Bitmap Editor etc) are ‘in the 
box’ along with the resource compiler, 
header files and libraries. Specialist SDKs, 
for things like multimedia and pen exten- 
sions, still have to be purchased separately. 


CodeView, now up to version 4.0, has been 
rewritten from scratch and implements a 
host of improvements, including full sup- 


THE SOFTWARE CONSTRUCTION COMPANY 
UPGRADE TO MICROSOFT C/C++ 7.0 


Available directly from THE SOFTWARE CONSTRUCTION COMPANY LTD. your 
upgrade to Microsoft C/C++ 7.0 for only £149 plus V.A.T., includes next working day courier. 


Competitive Upgrades to Microsoft C/C++ 7.0* 


TMOpSpecd Crteicseateasskscerctssareessss .£149 
Turbo/Borland C++ (any version) .£149 
ZOMSCH CH Aa (ANY VELSION ccsivsssAoseaiescessipsseacuaatssasstcessste ona seatatenssistnstlantactireee see NNeves sas sshteeencekesbaee sestuetuaheecriaaes £149 


* Requires copy of invoice to prove that competing product was purchased prior to February Ist 1992. 


How do | upgrade from Microsoft C 5.1/6.0 ? 

To upgrade from Microsoft C 5.1/6.0 to Microsoft C/C++ 7.0 please supply a copy of your original invoice or 
the set-up diskette, together with a cheque for £175.08 (£149 plus V.A.T.) or credit card details, Access/ 
Mastercard or Visa accepted. 


How do | upgrade from a competing C++ compiler ? 

To upgrade from either Borland or Turbo C++, Topspeed C++ or Zortech C++, which must have been 
purchased prior to 1st February 1992, please supply a copy of your original invoice, together with a cheque for 
£175.08 (£149 plus V.A.T.) or credit card details, Access/Mastercard or Visa accepted. CIRCLE NO. 458 


1 THE MALTINGS, GREEN DRIFT, ROYSTON, HERTS. SG8 SDB 
TELEPHONE (0763) 244114 FACSIMILE (0763) 244025 


CHARTBUILDER 


@ Integrate graphs and charts directly into Lilet cae Mi 

your Visual Basic applications. I Cian eset Windies 
Gap) 

@ Manipulate your graph objects using Grape ET evn) 
standard Visual Basic properties, events — 
and methods. 

@ Present your data as pie, bar, line, scatter, 
area, gantt, polar and high-low-close 
graphs. ‘ 

@ Add statistical lines and trends. 

@ Create high-quality hardcopy. 


@ Interchange images with other 
applications via Clipboard and Metafile. 


@ Pay no royalties on the applications you 
create. 


@ ChartBuilder comes complete with a 
royalty free run-time copy of Bits Per 
Second’s Graphic Server, the unique 
charting library for Windows 
developers. 


oft Vig; 
lelp wel Basic design} 


Torn) 


Sales Report f 


Bits Per Second Ltd 
14 Regent Hill, Brighton BN1 3ED 
Tel: (0273) 727119 Fax: (0273) 731925 £99.00 + VAT 
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port for C++, remote debugging (via RS232 
serial link) and DOS-extended applica- 
tions. The Programmer's WorkBench 
(PWB), much-criticised when it first ap- 
peared in v6.0, has also been revamped in 
version 2.0. A new overlay manager called 
MOVE (Microsoft Overlay Virtual Environ- 
ment) is also included in the package to 
compete with Borland’s VROOMM, and a 
copy of the company’s Source Profiler - 
previously only available as a seperate pro- 
duct - has been thrown in for good 
measure. 


What’s new? 


Obviously the major new feature of C/C++7 
is its support for C++, but it is also an 
upgrade of C 6.0 for s 
A number of new size and speed optimis- 
ations have been introduced including the 
facility to generate packed code or ‘p-code’. 
This technology has been used internally at 
Microsoft for several years and is employed 
in some of its home-grown applications 
such as Word, Excel and PowerPoint. P- 
code can shrink the memory requirements 
of an application by 40 to 60 percent, al- 

File Edit Search 


tatBar. 
gStatBar 


t {Defer indouPo 
cx, cy — 
ndDeferW indowPos Chdup) > 


Chdup, m_ 


raight C programmers. - 


Project Run _ Options 


yStatBar + cyBorder, 


though of course there is a run-time over- 
head. For DOS programs it may be used to 
compress code that might otherwise re- 
quire overlays, and under Windows it is 
advantageous to have programs as small as 
possible to allow the operating system to 
juggle memory more effectively. 


With p-code, application source code is 
compiled into ‘interpreted object code’, 
which is a higher-level and more compact 
representation of object code. A small (9 
KB) interpreter module is then linked into 
the application so that no other special 
software needs to be loaded. 


P-code generation is turned on by a simple 
compiler optimisation switch (/Oq) and re- 
quires little effort on the part of the pro- 
grammer. A #fpragma directive can also 
be used to generate p-code for selected 
non-time-critical functions in a single source 
file, so that p-code and native code can be 
included in the same object file. 


Microsoft recommends that user-interface 
code is a good candidate for p-code be- 
cause under Windows the user perceives 
indow Help 
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Figure 2 - PWB’s Browse menu 
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Figure 3 - PWB’s class hierarchy browser 
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almost no decrease in speed (presumably 
because Windows itself is so slow). 


Enhanced speed optimisations include un- 
restricted function inlining, automatic func- 
tion inlining and better near data allocation. 


Microsoft also claims to have dramatically 
improved compilation speeds with 
C/C++7. I must confess that on the admit- 
tedly trivial applications that I tested, I did 
not find a significant improvement over C 
6.0. However, I shall reserve judgement 
until a retail version of the compiler can be 
tested, Taking the cue from Borland C++, 
Microsoft has now implemented pre-com- 
piled headers. The use of these obviously 
can reduce compilation times greatly. 
Microsoft's implementation has the advant- 
age over Borland’s of allowing executable 
code to be pre-compiled as well as header 
information, An unfortunate side-effect of 
this flexibility is that it is more cumbersome 
to use than Borland’s offering. Because lite- 
rally anything can be in a pre-compiled 
header, the programmer has to tell the com- 
piler where the ‘header’ stops. This is done 
by embedding a #pragma hdrstop in 
the source file (see Figure 5). A pre-com- 
piled header file has to be explicitly cre- 
ated, maintained and used through a 
number of compiler switches. 


One of the main criticisms levelled at MSC6 
was its inadequate documentation. Micro- 
soft has responded to this by supplying 
heaps of the stuff with version 7.0. The 
10-manual set runs to about 5,000 pages 
and is pretty comprehensive, Most of the 
information is also available online in the 
PWB (although I’m not a fan of the PWB's 
Help system - even though there is a new 
Global Search option). 


C++ 


The C++ compiler of C/C++7 is a full im- 
plementation of the AT&T version 2.1 lan- 
guage specification including support for 
true nested types (ie proper scoping of 
‘class within a class’-type declarations). 
Microsoft has also included prototype ver- 
sions of more advanced C++ features such 
as templates and-exception handling (Bor- 
land C++ V3.0 implements templates as part 
of the language, but has no mechanism for 
exception handling at all). 


Exception handling is implemented as a 
system of macros which expand to C++ 
control structures and function calls. Al- 
though not identical to the proposed ANSI 
implementation, it should be relatively easy 
to port code written using the macros when 
the facility becomes part of the language 
proper. For example, in C/C++7: 


VISUAL INTERFACE 


We led the way with dGE. This is the other 
indispensable library for Clipper. For the 
first time your Clipper programs can have 
the look and feel of a Windows application. 


Visual interface has it all.... 


Multiple windows that can be moved, sized, 

maximized and minimized 

A complete range of interactive controls 

An integrated event handler 

Simple to program 

Fully object-orientated 

Runs dGE graphics in it's windows 
Your applications will never be the 
same.... 
@ Create graphical dialog boxes, data-entry 

forms and context-sensitive help screens 

Select files from scrolling list boxes 

Import bit-mapped images 

Create queries using icons, radio buttons, and 

check boxes ian 
® Run several windows concurrently and move Price: £245.00 

between them with a keystroke or mouse-click From: Bits Per Second Limited 
VI comes with a 250 page manual 14 Regent Hill, Brighton, E.Sussex BN1 3ED 
including over 100 pages of tutorial with Tel. 0273 727119 — Fax 0273 731925 
examples. Requires: Clipper 5.01 The VI library contains elements of Classly) and SuperClass issued under licence. You do not 

DOS 3.x or higher need to buy these products to use VI with Clipper 6.01 
640K RAM Class(y) (c) Anton van Straaten 


SuperClass (c) Chydale Software 
EGA or VGA GE, Visual Interface (c) Bits Per Second Ltd. 
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Totally unattended operation 


Interactively learns the keys you press and 
the time between each keystroke 


Remembers Control, Alt and Shift keys 
Decision making capabilities within tasks 
Executes your tasks at any time, day or night 


Power failure recovery during automated 
processes 


Automatic Day and Date function 
Maintains time delay between keys 
Unlimited number of jobs and keys 

Fast and convenient editing of keystrokes 


Put your PC on Autopilot... 


Hinata 


Automate your PC to carry out all your repetitive tasks. For example, 
set Autorun to run Month End routines, Print reports, Sort databases, 
perform Mailmerges, Import and Export Data or Files across networks, 
Log onto Mainframes via modems, backing-up or processing data 
automatically at any time, day or night. 

Autorun automation software will start-up, perform all assigned steps 
and terminate, no matter how complex, totally unattended. 


WHAT THE PRESS SAY... 


“Autorun is extremely easy for first time users to operate, 
the added features available to more experienced 
operators make it a very powerful suite of programmes 
indeed" — Micro Computer Mart, April 1991 


“A lot of man hours can be freed up by this program . . . 
Autorun is a worthwhile program that will find a welcome 
home in many offices." 

— Computer Shopper, October 1990 


“Autorun adds up to a very powerful 
(and rather clever) time saving utility." 
— What Micro, April 1991 
PRICE Also available in Network version at DISTR BUTORSS 
£ Asi) £299.95 exc, GUILDSOFT LD. 
GUILDSOFT DEPT.EXE 2THE COMPUTER COMPLEX, 
TURN YOUR PC INTO CITY BUSINESS PARK, STOKE, PLYMOUTH, DEVON PL3 48B 


egal YOUR PERSONAL ROBOT! (=)"Te)\lateyssee alse) \8) 
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programming 
editor for 
Windows 


@ Full Windows 
implementation 

Cut & Paste, nearly infinite Undo, 
Point and Click or key strokes control 
all features 


@ Multiple files and 
windows using MDI 

Load and view several files 
simultaneously in separate windows 


@ Folding text 

Manage large object modules with 
sections of text ‘folded’ up into a 
single line 


@ Code documentation 
Add ‘post-it’ style notes to any file 


@ Fully reconfigurable 
keyboard and menus 
Re-assign all keys and menus, make 
multiple key assignments 


@ Powerful macro 
language built-in 

Create and compile macros using 
any editor function with a Basic-like 
language 


@ £95 + VAT 


= 
file edit insert macro utilities options window 


project 
| 


sample.h | sample.c 
/* sample. "7 


define IDM_ABOUT 100 ra 

long FAR PASCAL WndFr(HWND.WORD.WORD,DWORD); 

BAU Tong FAN PASCAL WndFnIWND HWnd WORD message WORD wParam DWOAD dwParam) 
FARPROC IpProcAbout; KWindow . ” — ~ 


switch{message) { 
case WM_COMMAND: 


caseWM_DESTROY: EW 
PostQuitMessage(0); 
break; 

case WM_MOUSEMOVE: fil 


default: 
return(DefWindowProc(hWnd,message,wParam,dwParam)); 


} 
retum{NULL): 


+o | 00005017 [ce \work\sample\semple.c 


A: more and more users switch to Windows 8, the 


demand for Windows software continues to grow. Yet 

much of the developer’s toolkit still runs under DOS. 
Writing for Windows has always been more complex than for 
DOS, and project management can be especially tricky as 
Windows programs tend to be made up of large numbers of 
files. 


ix was developed to enhance programmer productivity. ix 
runs under Windows, and uses all the standard GUI features — 
MDI, split windows, cut & paste, choice of fonts and colours. It 
also contains several unique features which allow the developer 
far greater control. 


With ix you can edit and test within Windows — no more 
switching in and out of a DOS editor. Compilation/make files 
can be launched from a ‘Browse’ window. 


Browse windows help you keep track of the multiple files of 
a Windows project. A browser can be created for each project 
and used to fire up edit windows, launch resource editors (such 
as SDKpaint) and run programs as in Program Manager. 


‘Post-it’ style notes can be stuck onto any source file — 
without modifying the file. Their names can be used to give a 
hypertext-like help system throughout your project. 


And there's more; our AdHoc macro language, reassignable 
keys, custom menus and free telephone support, but we 
haven't got space to tell you about all that here. For more 
information, call or write us and we'll send you our information 
pack. 


° positive limited 
e 22 westminster buildings ¢ 
e new york street ¢ 
e leeds Is2 7dt 
e 0532 343 104 e 


Microsoft is a trademark and Windows is a trademark of the Microsoft Corporation. Positive Limited reserves the right to change the 
specification of ix without notice. 
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// 


( 


{ 


Ve 
{ 


Me 


{ 


// 
Ms 
void MyApp 
f 


) 
// 
ds 


) 


{ 


) 
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Borland C++ OWL Application 


VILL LLL LLLLLLLLLLE eee 
#include <owl.h> 

#include "winres.h" 

extern "Cc" 


include <stdio.h> 
#include <time.h> 
finclude <string.h> 


#define WM_MYMSG WM_USER + 1 
] EOD SOOO OOOO OOHOEHOO® Cass Definitions os HOG ONE IO SEK 


class MyApp : public TApplication 


public: 


MyApp( LPSTR AName, HANDLE hInstance, HANDLE hPrevInstance, 
LPSTR lpCmdLine, int nCmdShow ) 
: TApplication( AName, hInstance, hPrevInstance, lpCmdLine, 
nCmdShow ) {) 
void InitMainWindow(); 


class MainWnd : public TWindow 


private: 


int num_msgs; 
time_t start; 
char text (100); 


public: 


MainWnd( PTWindowsObject AParent, LPSTR ATitle ); 

void TimeMessages( RTMessage ) = (CM _FIRST + IDM_TIMECOUNT); 
void MyMsg( RTMessage ) = [WM_FIRST + WM_MYMSG); 
void WMPaint ( RIMessaqe ); 

void WMMouseMove( RTMessage ) = [WM_FIRST + WM_MOUSEMOVE); 
void WMActivate( RTMessage ); 

void WMCreate( RTMessage ); 

void WMHScroll( RTMessage ); 

void WMLButtonDown( RTMessage ); 

void WMMove( RTMessage ); 

void WMSize( RTMessage ); 

void WMVScroll( RTMessage ); 

void WMDestroy (RTMessage) 


] Dodoo odo toaaonaaonao: Tmplementation code ia icn a annn 
// Main program loop 
int PASCAL WinMain( HANDLE hInstance, HANDLE hPrevInstance, 


LPSTR 1pCmdLine, int nCmdShow ) 


MyApp ma( "Borland OWL Application", hInstance, hPrevInstance, 
lpCmdLine, nCmdShow ); 

ma.Run(); 

return ma,Status; 


Initialise main window 


InitMainWindow() 


MainWindow = new MainWnd( NULL, Name ); 


MainWnd 


MainWnd( PTWindowsObject AParent, LPSTR ATitle ) 
TWindow( AParent, ATitle ) 


num_msgs = 07 
stropy( text, "Select menu item to start test" ); 
AssignMenu( "MainMenu" ); 


W-~ 
// EVENT HANDLERS 

M~ 

void MainWind :: TimeMessages( RTMessage ) 


// initialise data 

num_msgs = 0; 

strcpy( text, "Processing messages..." ); 
InvalidateRect ( HWindow, NULL, TRUE ); 
UpdateWindow( HWindow ); 

time( @start 
PostMessage( HWindow, WM_MYMSG, 0, 0 ); 


void MainWnd :: MyMsg( RTMessage ) 


if ( nummsgs < 10000 ) 
( 
num_msgs++; 
PostMessage( HWindow, WM_MYMSG, 0, 0 ); 
) 
else 
if 
time_t end; 
time( gend ); 
int elapsed = difftime( end, start ); 
sprint£( text, "Time taken to process 10,000 messages = %d 
seconds", elapsed ); 


Figure 4 - Borland OWL TIMER.CPP 


OOOO ICIS GOI TOSI CTI IITA IIIS IIIT TOSS II SII IIIT 
V7 Microsoft C++ MFC Application 
BODO II OSI TOE IOI TODO IO III I IA II AI I AAI II I I A AI AI IO I A AIA 
#include <afxwin.h> 
#include "winres.h" 
extern "Cc" 
{ 
#include <stdio.h> 
#include <string.h> 
} 
#define WM_MYMSG WM_USER + 1 
#pragma hdrstop 
[OOOO OOOO OOOO OO R0% Class Definitions SECON IOI OE 
class MyApp : public CWinApp 
{ 
public: 
BOOL InitInstance(); 
Me 
class MainWnd : public CFrameWnd 
{ 
private: 
int num_msgs; 
CTime start; 
CString text; 
public: 
MainWnd(); 
void afx_msg TimeMessages (); 
LONG afx_msg MyMsg( UINT wParam, LONG lParam ); 
void afx_msg OnPaint () 
void afx_msg OnMouseMove( UINT flags, CPoint point ); 
void afx_msg OnActivate( WORD state, CWind * pOther, BOOL bMinimised ) 
int afx_msg OnCreate( LPCREATESTRUCT pCreateStruct ); 
void afx_msg OnHScroll( WORD SBcode, WORD pos, CWnd * pScrollBar ); 
void afx_msg OnLButtonDown( WORD flags, CPoint point ); 
void afx meg OnMove( int x, int y )7 
void afx_msg OnSize( UINT type, int cx, int cy ); 
void afx_msg OnVScroll( WORD SBcode, WORD pos, CWnd * pScrollBar ); 
void afx_msg OnDestroy(); 
DECLARE_MESSAGE_MAP () 
WE Te Ce 
crrtrett tere eeeeeceeeeerr ers 
// instantiate global application object 
MyApp theApp; 
| /===mmmnm 
// Initialise main window 
//aeetnnnnenneneneseense 
BOOL MyApp :: InitInstance() 
{ 


m_pMainWnd = new Maintind(); 
m_pMainWnd->ShowWindow( m_nCmdShow ); 
m_pMainWnd->UpdateWindow () ; 
return TRUE; 

) 


//saeemenenn 


// Mainvnd 


BEGIN_MESSAGE_MAP( MainWnd, CFrameWnd 
ON_COMMAND( IDM_TIMECOUNT, TimeMessages ) // menu message 
ON_MESSAGE( WM_MYMSG, MyMsg ) // user-defined message 
ON_WM_PAINT () // event handlers... 
ON_WM_MOUSEMOVE () 
ON_WM_ACTIVATE () 
ON_WM_CREATE () 
ON_WM_HSCROLL() 
ON_WM_LBUTTONDOWN ( 
ON_WM_MOVE () 
ON_WM_SI2E() 
ON_WM_VSCROLL () 
ON_WM_DESTROY () 
END_MESSAGE_MAP () 
Whe + 


// Constructor 


MainWnd () 


num_msgs = 

text = "Select menu item to start test"; 

Create( NULL, "Microsoft MFC Application", 
WS_OVERLAPPEDWINDOW, rectDefault, NULL, "MainMenu" 


} 
PN fos = 
// EVENT HANDLERS 


Mr 
void MainWnd 
{ 


TimeMessages () 


// initialise data 
num_msgs = 0; 

text “Processing messages... 
InvalidateRect ( NULL, TRUE ); 
UpdateWindow (); 

start = CTime::GetCurrentTime(); 
PostMessage( WM _MYMSG, 0, 0 


2 
LONG MainWnd :: MyMsg( UINT, LONG ) 
{ 
if ( nummsgs < 10000 ) 
{ 
num_msgs++; 
PostMessage( WM_MYMSG, 0, 0 ); 
} 
else 
{ 


Figure 5 - Microsoft MFC TIMER.CPP 


.EXE Magazine, Vol 6, Issue 8, February 1992 


39 


Microsoft C/C++ 7.0 


InvalidateRect ( HWindow, TRUE ); 
} 

} 

void MainWnd :: 


{ 


NULL, 


WMPaint ( RTMessage ) 


RECT rect; 
PAINTSTRUCT ps; 
HDC hDC = BeginPaint( HWindow, &ps )7 


GetClientRect ( HWindow, &rect ); 
SetTextAlign( hDC, TA_BASELINE | TA_CENTER ); 
SetBkMode( hDC, TRANSPARENT ); 


text, strlen(text) )7 
EndPaint ( HWindow, &ps ); 

rete MainWnd :: 
; TWindow: :WMActivate( msg )+ 
Tote MainWnd :: 
: TWindow: :DefWndProc( msg ); 
tote MainWnd :: 
: TWindow: :WMCreate( msg ); 
yore MainWnd :: 
: TWindow: 
ete MainWnd +: 
: TWindow: :WMLButtonDown( msg )7 
voit MainWnd :: 
! ‘TWindow: :WMMove( msg ); 
vata MainWnd :: 
: TWindow: 
Hola MainWnd ++ 
; ‘TWindow: :WMVScroll( msg ); 
wet MainWnd +: 
: ‘TWindow: 
) 


WMActivate( RTMessage msg ) 


WMMouseMove( RTMessage msg ) 


WMCreate( RTMessage msg ) 


WMHScroll( RTMessage msg ) 


:WMHScroll( msg ); 


WMLButtonDown( RTMessage msg ) 


WMMove ( RTMessage msg ) 


WMSize( RTMessage msg ) 


:WMSize( msg ); 


WMVScroll( RTMessage msg ) 


WMDestroy( RTMessage msg ) 


:WMDestroy( msg )7 


TextOut( hDC, ( rect.right / 2), ( rect.bottom / 2 ), 


CTime end 


sprintf ( buffer, 


text = buffer; 
} 


return OL; 


void MainWnd :: 
{ 


cRect rect; 


} 
void MainWnd :: 
{ 

CFrameWnd: 
} 
void MainWnd :: 


CFrameWnd: 
) 
int MainWnd :: 
{ 


foie MainWnd :: 
CFrameWnd; 
youd MainWnd +: 
’ CFrameWind: 
yoid MainWnd :: 
‘ cFrameWnd: 


void MainwWnd :: 
{ CFrameWnd: 
wld MainWnd i: 
; cFrameWnd: 
yeta MainWnd :: 
: cFrameWnd: 
} 


CTimeSpan elapsed = end - start; 

char buffer(100); 

“Dime taken to process 10,000 messages = %d seconds", 
elapsed.GetTotalSeconds() )7 


InvalidateRect ( NULL, 


OnPaint () 


cPaintDC de( this ); 

GetClientRect( rect ); 

de.SetTextAlign( TA_BASELINE | TA_CENTER ); 

dc. SetBkMode( TRANSPARENT ); 

de.TextOut ( (rect.right / 2), 
text, text.GetLength() ); 

OnMouseMove( UINT flags, CPoint point ) 

:OnMouseMove( flags, 

OnActivate( WORD state, CWnd * pOther, BOOL bMinimised ) 

:OnActivate( state, 

OnCreate( LPCREATESTRUCT pCreateStruct ) 

return CFrameWnd::OnCreate( pCreateStruct ); 

OnHScroll( WORD SBcode, WORD pos, CWind * pScrollBar ) 

:OnHSerol)( SReode, pos, pScrollBar ); 

OnLButtonDown( WORD flags, CPoint point ) 

:OnLButtonDown( flags, point ); 

OnMove( int x, int y ) 

:OnMove( x, y )i 

OnSize( UINT type, int cx, int cy ) 

:OnSize( type, cx, cy )i 

OnVSeroll( WORD SBcode, WORD pos, 

:OnVSeroll( SBcode, pos, pScrollBar ); 

OnDest roy () 


:OnDestroy (); 


= CTime: :GetCurrentTime(); 


TRUE ); 


(rect.bottom / 2), 


point ); 


pOther, bMinimised ); 


cWnd * pScrollBar ) 


Figure 4 - Borland OWL TIMER.CPP (Continued) 


TRY 
{ 
do_something(); 
} 
CATCH( ExceptionClass, 


{ 
// e is an instance of the 
// exception object 


e) 


} 
AND_CATCH( ExceptionClass, 
{ 


e) 


} 
END_CATCH 


System proposed by Stroustrup: 


try 
{ 
do_something(); 
} 
catch( ExceptionClass e ) 
{ 


} 
catch( ExceptionClass e ) 
{ 
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Template definition is also at a prototype 
stage and declarations must be converted 
to v2.1-compliant header files and .CPP files 
using a TEMPLDEF utility (for which the 
source code is provided). This is not too 
much of a hindrance, given that a number 
of common templates are provided in the 
class libraries shipped with the product, 
and programmers will not often need to 
define their own. As with exception hand- 
ling, Microsoft plans to incorporate tem- 
plates (and any other syntax) into the 
language proper only when an ANSI stand- 
ard is available. 


Class libraries 


The availability of high-quality class libraries 
is perhaps the most important factor in tak- 
ing full advantage of OOP and C++. With 
C/C++7, Microsoft has included an exten- 
sive range of DOS and Windows classes 
collectively referred to as Microsoft Foun- 
dation Classes (MFC - Figure 1). This group 
of classes is part of a wider hierarchy called 
Application Framework Extensions (AFX ). 
The framework is incomplete at the mo- 
ment (consisting only of the MFC group) but 


Figure 5 - Microsoft MFC TIMER.CPP (Continued) 


will be filled out in the compiler's next 
release. Full source code is included for al 
classes, 


Itcan be seen that the MFC hierarchy is ‘flat’ 
or ‘granular’, meaning that there are not 
many levels in the tree. There are relatively 
few classes, but they have many methods. 
Most objects are derived from a superclass 
CObject. Unlike Borland’s ObjectWin- 
dows Library (OWL), the MFC Windows 
classes encapsulate almost the whole of the 
Windows API, so one should not need to 
‘kickdown’. Microsoft has also provided an 
excellent range of general utility classes 
such as CString andCTime. 


Dealing efficiently with message handling 
in GUI environments has become a moot 
point in C++ circles. The problem is that 
because Windows itself is not truly object- 
oriented you end up with enormous virtual 
function tables and are still left with a slow 
switch structure in a main window pro- 
cedure (or ‘dispatcher’). Borland got round 
the problem by a language extension 
whereby a Windows message number is 


associated with a virtual function in the 
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class declaration (see .EXE Nov 91), Micro- 
soft has taken a slightly different approach 
by using a system of macros and the addi- 
tion of the afx_msg keyword. The key- 
word acts a bit like the virtual method 
modifier but does not have its implicit be- 
haviour when it comes to inheritance - the 
macros you use have to tell the compiler 
what is the object’s immediate base class. 


Jsing Borland 
pointers to a window’s event handlers and 
their associated message numbers is gener- 
ated by the compiler and held as a Dynamic 
Yispatch Virtual Table (DDVT) adjacent in 
memory to the class's ordinary Virtual 
Method Table (VMT). With MFC, the DE- 
CLARE MESSAGE MAP () macro de- 

S imilar array of pointers and 
numbers within the class declaration. This 
array is then subsequently initialised in a 
BEGIN _MESSAGE_MAP () macro block. 
When a window receives a message, a 
small assembler routine searches the array 
and matches the number with a function 
pointer in a similar way to Borland’s OWL. 


OWL vs MFC 
In order to test the relative efficiency of the 
two message routing systems and to 


’s OWL library, the array of 


examine the ease of Windows develop- 
ment using the class libraries, I devised a 
simple application. The program is called 
TIMER and it measures the time taken (in 
seconds) to proc 10,000 user-defined 
messages. The timer is kicked off by select- 
ing a menu item, and the elapsed time is 
displayed in the centre of the client window 
area. Anumber of simple information mess- 
ages are also displayed. The source code 
for OWL and MEC versions of this applica- 
tion are listed in Figures 4 and 5. To make 
the test a bit more realistic I inserted a 
number of extra ‘dummy’ event handlers to 
generate a reasonably sized message array. 
Lalso tested the programs ‘under stress’ by 
repeating the timer experiment while mov- 
ing the mouse pointer rapidly over the 
client window, thus generating thousands 
of WM_MOUSEMOVE messages. 


The results of this test are tabled in Figure 
6, It can be seen that the MFC application 
did not appear to process the messages as 
rapidly as its OWL equivalent. Iam wary of 
drawing too many conclusions from this 
because it is such a simple application, but 
it may indicate an area where Microsoft 
could make improvements. Microsoft com- 
pile and link times were also slower but 
.EXE sizes were considerably smaller than 
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their OWL counterparts. This is mainly due 
to Microsoft’s new ‘smart-method’ linker 
(similar to that supplied by JPD which strips 
out unused methods from the executable. 
The MFC source was slightly longer, pri- 
marily because of the need to declare the 
message map entries. This I found a bit 
annoying because it means that the pro- 
grammer effectively has to declare a win- 
dow’s event handlers twice - once in the 
class definition and again to initialise the 
af sage map. Message handling functions 
also have distinct prototypes (ie 
ive different parameters and re- 
turn different values). This is good in one 
respect because it means that the standard 
ssage parameters have al- 
ready been decoded into meaningful data 
(eg a mouse codrdinate). A downside of 
this is that it is necessary to look up and 
declare the exact prototype of an event 
handler you wish to override. 


Other matters 


The PWB has a very powerful class brow- 
ser. Browse information is generated at 
compile time by a set of compiler options. 
These cause the creation of separate SBR 
files which are then ‘compiled’ to a . 
browse database with the BSCMAKE utility. 
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Because the browse information is not con- 
tained in the .EXE file, there is no overhead 
and a great deal of detailed cross-reference 
information can be stored. In Turbo C++ for 
Windows, similar data is burned into the 
executable and is not nearly as detailed as 
that available in C/C++7. With the PWB’s 
class browser you can: display a list of all 
classes and their members in a ‘tree’ format 
(this is useful but not as good as a true 
graphical view); view all classes sorted by 
protection and scope; view all relationships 
between classes, class symbols, objects and 
member functions, Figures 2 and 3 show the 
PWB's class browser in action. 


Conclusion 


Microsoft has been very careful not to jump 
the gun in the race to C++ - one might even 
suggest that they have been slow off the 
blocks. But C++ is still an evolving language 
with many features not yet standardised. 
Microsoft’s goal has been to produce a ro- 
bust, reliable and above all correct im- 
plementation of C++, which is a highly 
complex language with many pitfalls for 
compiler-writers. 


First impressions indicate that, despite im- 
rovements, C/C++7 is still a bit on the slow 


Compiler Turbo C++ for Windows Microsoft C/C++ 7.0 
C¥¥ Windows Library | ObjectWindows (OWL) “MS Foundation Classes (MFC) 
Compile & link time =pch -debug 558 1m 15s 
-pch +debug im 11s 2m 20s 
+pch -debug 40s 47s 
+pch_+debug 55s 1m 32s 
TEXE size (bytes) =pch =debug 57344 4304 ae 
-pch +debug 127254 67584 
+pch -debug 57344 34304 
+pch +debug 127063 67584 
Number of lines of code 162 168 
Time taken to process = 
10,000 messages (secs) | -mouse mvt 10 
+mouse_mvt eet 0 ee 13 
NOTE: pch = pre-compiled header 
Data for a 25 MHz / 386-based PC with 4 MB RAM 


Figure 6 - Comparison of OWL and MFC versions of TIMER 


Microsoft C/C++ 7.0 


side with regard compilation speed, but I 
must state again that I was dealing with a 
beta version. I was also expecting great 
improvements in the PWB but was some- 
what disappointed. 


The class libraries supplied are very exten- 
sive and contain heaps of code to aid de- 
bugging. It does, however, seem a shame 
that vendors (Microsoft and Borland) have 
had to resort to language extensions/mac- 
ros to implement compiler-dependent solu- 
tions to the ‘Windows Problem’. 


Worth the wait? Yes, I think so. Microsoft’s 
commitment to producing code of the hig- 
hest quality should ensure that C++ becomes 
more widely used for major development 
projects. As always, there is room for im- 
provement, but I think the release of 
C/C++7 will herald the true dawn of C++. 
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Microsoft C/C++ version 7.0 will cost £335. 
Existing users of C 6.0 or (wait for i) any 
other C/C++ compiler (eg Borland, Zortech, 
JPI etc) can get a copy for £150. C/C++7 
should start shipping at the end of Fe- 
bruary. Microsoft is on 0734 500741. 
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s¢ BEYOND 640K DOS 


Let Phar Lap’s 286] DOS Extender” turn your Microsoft C 
compiler into a multi-megabyte power tool. 


It has never been so easy to C beyond 640K DOS. With your 


C and the Phar Lap 286|DOS Extender you have 


all the tools you need to build multi-megabyte, protected mode 


ly and easily — often by simply relinking without 


making source code changes. 286|DOS Extender enables you to 


jat have room for more features and capabilities 
having to suffer with overlays or EMS. Best of all, 


you do not have to forsake your Microsoft C tools, 
including your Code View debugger. No more “out of 
Heap” messages when compiling under Windows or 
with networks. 


Total Compatibility 


286] DOS Extender is embedded into your 


program, it is invisible to the end-user. Your program looks 
exactly like any other DOS application. There is no new 
operating environment for your end-user to buy or learn. 
Any of the 30 million 80286, 386 or 486 PCs that can run 
DOS can run with 286|DOS Extender. Since Phar Lap 
products support the XMS, VCPI and DPMI standards, 
applications built with 286 |DOS 

Extender can also run with DESQview 


and all modes of Microsoft Windows. j 
So if DOS is looking smaller than ever, call Systemstar 3 
today on (0992) 500919 and C what it looks like i 
beyond 640K — we open a world of memory. ° 
EN = 
2 MYSTEMSTAR = 
we a5 Ie M f T E D 
1-3 Parliament Square, Hertford, SG14 1EX 
Telephone: (0992) 500919 Facsimile: (0992) 554261 
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Editors 


Programmer’s Editors 


They say that a programmer's editor is his best friend. Cliff Saran looks at five offerings. 


A Programmer's Editor is probably the least 
considered programming aid. Before the 
birth of the PC, mainframe programmers 
had to rely ona systems editor. Today, the 
evolution of the standalone editor has pro- 
duced a highly configurable beast, offering 
an environment for editing and compiling 
that is superior to its IDE cousins, In this 
article, I shall be looking at five Programmer's 
Editors varying considerably in price, com- 
plexity and the features that they have to offer. 


QEdit 


While I was compiling a list of editors for 
this article, I came across a rather good- 
looking shareware offering called QEdit. 
QEdit provides many features that put it 
above more basic editors. 


First, it is fast. Even the largest file it could 
handle (about 490 KB) in my DOS setup it 


took milliseconds to load. Figure 1 shows a 
benchmark test that I ran on all the editors 
in this article. Buffer size is limited by the 


WU le 
... Epsilon is the 
only editor to 
support 
concurrent 
processing 


WML le 


amount of free memory on your machine. 
In fact, you can open as many files as you 
like, as long as you have enough free mem- 


Figure 1 : Programmer's Editors Benchmark 
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ory left. Since this memory pool is central 
to the functionality of QEdit, if you are 
using a large Scratch buffer (eg during a 
Cut/Copy and Paste operation) it is best to 
flush the buffer once you've finished using 
it (by copying something smaller into it). 


Second, it is easy to use, There’s a menu 
system (activated with <ESC>), a status bar 
anda handy pop-up help screen that shows 
the key sequences for those frequently 
used operations (like Loading files or Cut- 
ting and Pasting). QEdit provides three 
ways to mark a block of text. A block may 
be marked as a group of rows or columns. 
Moving columns provides the easiest way 
to align a group of comments with the right 
margin or to add another level of indenta- 
tion to a block of code in a loop construct. 
The block may then be manipulated using 
a single key stroke (eg the grey ‘’, ‘+’ and 
keys perform cut, copy and paste oper- 
ations respectively). 


Since QEdit is quite a small program, using 
only 58 KB of memory, it leaves enough 
room in a DOS shell to run your favourite 
compiler. There is no way to trap compila- 
tion errors but the ability to compile within 
an editing session is a great advancement 
over using a command-line compiler - at 
least when you return to your editing ses- 
sion it will remain in the.same state as you 
left it (this is essential in QEdit as it doesn’t 
save session info when you quit). 


QEdit is configurable. It uses a separate 
program (QCONFIG.EXE) to change the 
working environment, and it has a key- 
board macro recorder. It supports C-style 
indentation and there’s also a built-in paren- 
thesis/bracket matching macro. Unfortunate- 
ly, itis not possible to change the printer port 
- printer output is hard-wired to LPT 1. 


QEdit provides all of the basic requirements 
of a good Programmer's Editor. There’s 
limited support for C programming style 
and compiling within the editor (although 
it doesn’t highlight the erroneous line like 
some of the more up-market offerings). 
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Unlike more complex editors, QEdit only 
uses a single executable (47 KB) so you can 
stick it onto a single floppy disk and run it 
on any machine you're using. You can reg- 
ister your copy of QEdit directly to Sem- 
Ware in the US by sending $54.95 (+$10 
shipping). However QEdit is also distributed 
in the UK (see Figure 5 for prices). A TSR 
and OS/2 version of QEdit is also available. 


Ed 


You probably haven’t heard about Ed yet, 
so I'll just put you in the picture. Ed began 
its life a long time ago (pre-CP/M) and was 
first ported to CP/M 80 and then on to DOS. 
In early 1990, the Australian company, Soft 
As It Gets, released a commercial version. 


There is a Status Bar at the top of the screen 
and a Function Key template at the bottom. 
This template shows what action each func- 
tion key (F1 to F10) performs. A pull-down 
menu can also be activated which gives the 
short-cut key strokes. There's also a context- 
sensitive Help system and online documen- 
tation. Standard editing functions like 
highlighting a rows or column of textare, of 


course, present. Ed supports extremely large 
files and utilises a virtual memory mechan- 
ism for swapping sections of a large file 
from memory to disk and vice-versa. There 


MM 


One of the 
cleverest features 
of Brief is its 
ability to work 
with third-party 

SouWgre 
dda 


MUM 
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can be up to eight windows on the screen 
at any one time and each window may be 
created by splitting the screen either hori- 
zontally or vertically. Files may be loaded in 
edit-mode or view-only, enabling the sharing 
of files over a LAN. 
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Escape Sequences 


Figure 2 - Epsilon’s Concurrent DOS session 
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Include: <stdio.h> 
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int printf ( char *format£, argument]... 
the number of characters printed. 


fprintf£, scanf, sprintf, vfprintf£, vprintf, usprint£ 
printf Formatting Table! 


Escape Sequen 
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Figure 3 - Context-sensitive Help in Brief 
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Editors 


To get the most satisfaction from using Ed, 
you have to write C/C++ source, It directly 
supports Zortech C/C++, Turbo C/C++ and 
Microsoft C compilers and there are several 
built-in utilities which will ease the burden 
of writing code. First there’s C-style inden- 
tation, parenthesis-matching and a handy 
line commenting macro. Then there is the 
template feature. Now this is a real time- 
saver. Templates work by replacing a single 
character by a complete C construct eg 
<ESC>s<ESC> produces the following : 


switch ( ) 


{ 
case : 
break; 
default 
break; 
} 


Do you ever need to quickly look up the 
definition of an external function that you're 
using? CTAG is a program that keeps a 
record of C function call definitions (it also 
works with non-inline C++ member func- 
tions). Once all your files have been pro- 
cessed by CTAG, you can simply view the 
file containing the function definition by 
invoking Ed’s Edit File menu option, and 
specifying the name of the function you wish 
to see. Ed will automatically load the rele- 
vant file and place the cursor on the first line 
of the function’s definition. Ed even pro- 
vides you with a function browser for 
moving to a given function definition with- 
in the file that you're currently editing. 


There are also a few pop-up utilities bundled 
with ED. These include a nifty calculator 
that can convert from decimal to binary or 
hex. There's a built-in ASCII table and a 
table showing the C precedence rules. Al- 
though I have concentrated on ED’s C pro- 
gramming features, I must point out that it 
also supports Pascal, Assembler, M odula-2, 
Clipper and dBASE. ED is a feature-packed 
editor, filled to the brim with clever ideas 
for writing code faster, and more efficiently. 


Epsilon 

Although all the Programmer's Editors in 
this article were tested under DOS, there are 
imes when you'd like to use your favourite 
editor on a different platform (like OS/2 or 
UNTX). As you already know, all UNIX ma- 
chines are guaranteed to have a copy of vi. 
vi is even available under DOS and OS/2. 
owever, I can’t see many DOS pro- 
grammers moving over to vi! Epsilon 
from Lugaru) is available for DOS, OS/2, 
SCO UNIX and Interactive 386/ix, provid- 
ing true multi-platform editing. Unfortu- 
nately this limits its capabilities, since many 
UNIX terminals lack even the most basic 
cursor controls and text highlighting fa- 
cilities. 
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C-scape Features 


@ Graphics — Combine high-resolution graphics 
with text or menus. 


@ Object-oriented — Add features and create 
re-usable code modules. 


@ Mouse — Use any standard mouse for fast 
screen control. 


© Portability — Write hardware independent 
code. Supports MSDOS, OS/2, UNIX and 
VMS. Auto-detects: Hercules, CGA, EGA, 
VGA. 


@ Text Editing — Create a full-featured text 
editor or pop-up note: pad. 


© Field flexibility — Create masked, protected 
and marked fields with complete data i 2) 
validation. Use time, date, money, pop-up 
list and many more functions — or create 


ease of C-scape. In the US, /EEE 
Computer said “C-scape is by far the best 
... a joy to use.” PC Magazine chose 
C-scape to produce its Laboratory 
Benchmark Series 5.0 software because 
C-scape offers mouse support. Moreover, 
C-scape simultaneously combines text 
and graphics. 

C-scape, from LIANT SOFTWARE 
CORPORATION, is built around an open 
architecture, so it can be used with data 
management or other C libraries. At 
Systemstar, we offer C-scape with Raima 
Data Manager from Raima Corporation 
to provide a complete development 


your own. 


@ Windows — Choose from pop-up, tiled, 
bordered and exploding windows with size 


The C-scape” Interface Management 
System frees C programmers from the 
tedium of coding windows, menus, data 


environment. 
To port your application from MSDOS or 


OS/2 to UNIX or VMS, just recompile. 


Source code is included in the price and 
there are NO RUN-TIME ROYALTIES. 


For more information about C-scape 
call Systemstar on (0992) 500919. 
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SYSTEMSTAR 


1-3 Parliament Square, Hertford, SG14 1EX 
Telephone: (0992) 500919 Facsimile: (0992) 55426] 


and numbers limited only by RAM. 


@ Menus — Choose from pop-up, pull-down, 
123-style or slug menus — or create your 
own. 


validation, help and text editing 
functions. 


C-scape is a pleasure to use. With 
C-scape’s object oriented design you can 
build more flexible, more functional, 
more portable and unique applications — 
and you will enjoy doing it. 

The Industry Standard. 

Many thousands of programmers have 


given up home-grown libraries and 
cumbersome, inflexible products for the 


@ Context sensitive help — Link help messages 
to individual screens or fields. Cross 


reference messages to create hypertext-like 
help. 

@ Screen design — Build any type of screen or 
form with Look and Feel” screen designer, 
which will then automatically convert to C. 


© Screen flexibility — Call screens from files at 
run-time or link them. 
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London W13 9NH. England 
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DISPLAYS WITH OVERLAY CAPABILITY 
% 100% COMPATIBLE WITH IBM 
VGA/EGA/CGA/MDA VIDEO STANDARDS 


%* 4 BOARDS IN ONE SYSTEM GIVE 8 
SIMULTANEOUS DISPLAYS 


NEW DRIVER! ALLOWS WINDOWS 3.0 TO 
BE EXPANDED ACROSS FOUR MONITORS 


CEBRA COMMUNICATIONS LIMITED 
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Epsilon uses EMACS-style commands, al- 
though it is highly configurable. It has a 
status bar which shows the filename, type 
of buffer and the percentage of the buffer 
that has been scrolled down. 


In addition to the standard text buffer, Ep- 
silon supports a further three special buffer 
types - each of these may be displayed in 
its own window. First there is the bufed 
buffer which holds a list of buffers together 
with the files that are associated with them. 
bufed operates in a similar way to how 
the buffer list-box works on other editors. 
Scrolling through the list enables you to 
select the current buffer. 


Second there’s the dired buffer which 
contains a listing of the current directory. It 
is possible to select files for deletion using 
the ‘D’ key to place a flag on the files you 
want to delete. The ‘X’ key actually removes 
these files, after verifying that this is really 
what you want. Pressing <Enter> ona given 
file causes the editor to load the chosen file 
into the current window. 


Next there is the C buffer type. When a C 
program is loaded into a C buffer, the editor 
produces C-style indentation and paren- 
thesis/bracket matching. Compiling the 
contents of a C buffer is a rather involved 
procedure. This is because Epsilon defaults 
to the UNIX make command, To use 
Microsoft C you have to pass a dummy 
parameter to the Epsilon make macro 
which causes the macro to prompt you for 
a command-line. Compilation errors are 
trapped by Epsilon and you can step 
through them using <CTRL>X <CTRL>N. 
Epsilon also provides a tag facility for 
cross-referencing functions. Running this 
command on all C source files produces a 
ist of function definitions with filenames 
and line numbers. However, it is not 
possible to select a function to read into a 


buffer - you have to load the file containing 
the function definition manually, and ‘cur- 
sor-down’ to the relevant bit of code. This 
‘tag’ file is like a normal text file and can be 
opened any time. 


WU 


SPE will even run 
Windows 
Enhanced mode 
from within the 
DOS window 


WUMMMVH/E@EXVVLLLL 
Finally there is the process buffer. A 
concurrent task runs in this buffer, and 
what’s more, it even works under DOS (see 
Figure 2) - Lugaru claims that Epsilon is the 
only DOS editor to support concurrent pro- 
cessing (although under DOS, Epsilon will 
only support one concurrent task). The 
main problem with the process buffer is 
that it doesn’t leave enough memory in the 
DOS shell to run anything useful - on my 
machine, a typical concurrent editing ses- 
sion left about 150 KB for DOS Ge not 
enough to run a compiler or a linker), To 
get around this, Epsilon offers an ‘Exit to 
DOS’ command which needs only 6 KB. 


I have never used EMACS before, so most 
of the keyboard sequences came as quite a 
shock. This is made worse by the fact that 
there isn’t a menu system, so you have to 
remember dozens of keystrokes. Luckily 
the Epsilon manual is well-presented and 
easy to use. There is online help, but I don’t 
recommend you use it, since it is extremely 
tedious. Epsilon is a fine editor, although it 


mtest.c [ 1, 411 
uxoid Message (char *Msg) 


printf ('Nnzs", Msg); 


void ReadIn (char «DSS ,0D (EM 
£ 


7* read a line 


bautoexec.bat [ 1, 


PATH C:\LANMAN DOSS 

SET TEMP=C:\DOS 

C:\DOSNKEYB UK, ,C:\ 

REM LANMAN 2.8 

C!\LANMAN . DOSNDRIVERSNPROTMANNNETB IND 
NET START WORKSTATION 

REM 

LOADHIGH doskey 


Microsoft(R) MS-DOS(R) Version 5.08 
(C)Copyright Microsoft Col} 


fl] DEV ICEHIGH=C : NLANMAN . DOSNDRIVERSNETHERYS 


Ito return to Sage Professional Editor, type "EXIT". 


\COUNTRY .SYS 
DOS\COMMAND.COM C:NDOSN 7p 


Figure 4 - Overlapping Windows in SPE 
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Editors 


lacks some of the more ‘user friendly’ fea- 
tures found on most DOS editors. 


Brief 


I've been reliably informed that Brief is one 
of the most popular Programmer's Editors 
for DOS and O$/2. So, why do people buy 
it? What do you get for two hundred quid? 
(Brief costs nearly as much as a good C 
compiler.) 


Brief is supplied with a lot of documenta- 
tion - over 600 pages in total, split into a 
user manual anda macro reference manual. 
There is also online Help and a context-sen- 
sitive Help system. The Help system is easy 
to use and provides useful info on most of 
Briefs features, including help on how to 
manipulate Blocks, Buffers, cursor con- 
trols, windows and how to perform search 
and replace. 


There is a setup program to reconfigure 
Brief after it has been installed. This auto- 
matically makes changes to your CON- 
FIG.SYS and autoexec.bat files. In 
addition to being able to configure the 
screen colours, line length, number of le- 
vels of undo etc, the setup program allows 
you to provide a command-line for compi- 
lation inside Brief. 


Brief supports several languages including 
Ada, Basic, C, Cobol, Fortran, Modula-2 and 
Pascal. <ALT> F10 compiles the current 
buffer and produces a list of compilation 
errors in an error list-box, activated with 
<CTRL> P. It is possible to select which 
compiler to run, although this can only be 
done in the setup program. The file exten- 
sion enables Brief to identify which com- 
piler to invoke when <ALT> F10 is pressed 
(ie a .C file is compiled with CL, a .asm file 
is assembled with MASM). Briefs support 
for C, provides the programmer with a tem- 
plate facility (like Ed’s) to reduce typing. 
Unlike Ed, this only requires a single char- 
acter followed by a space to invoke the 
template macro. For instance the key se- 
quence <i> <space> produces the follow- 
ing: 
re () 


One of the cleverest features of Brief is its 
ability to work with third-party software. 
Brief has built-in support for the PVCS, TLib 
and Sourcer’s Apprentice version control 
system, although I was not able to test this 
personally. There is also support for the 
Microsoft Programmer’s Workbench 
(PWB) and Microsoft’s Quick Help (sup- 
plied with Microsoft C V6.0). Quick Help 
provides context-sensitive Help on C syn- 
tax and standard functions. It’s very neat. 


F77L-EM/32 & Lahey Ergo OS/386 


Port mainframe programs as large as 96MB to 386/486's with 
this 32-bit DOS-Extender compiler. The winner of PC 
Magazine’s 1988 Technical Excellence Award just got better. 
New Version 4.0 includes: Programming Tools, Popular Fortran 
90 features, Virtual Memory Support, DESQView support, New 
Documentation and Free Unlimited Runtime Licenses. 
F77L-EM/32 and OS/386. £875.00 plus VAT 


F77L 


The fastest real-mode compiler available. F77L can take 
advantage of your 386 PC by generating 32-bit instructions. New 
Version 5.0 includes: Fortran 90 features, Weitek support, and 
Video Graphics. £375.00 plus VAT 


Lahey Personal Fortran 77 


Version 3.0: Full ANSI 77, Editor, Debugger, Linker, Library 
Manager, Microsoft and Borland C interfaces. A great learning 
tool at an unbeatable price. £79.00 plus VAT. 


When people talk about FORTRAN 
the name mentioned, most often is 


3-5 Cynthia Street, London N1 9JF 
Tel: (071) 833 1022 Fax: (081) 837 6411 


CIRCLE NO. 472 


CopyControl 


THE NEW GENERATION 
OF COPY PROTECTION 


User hassle 


Back-up problems 

Hardware add-ons or special disks needed 
Changes to source code required 
CopyControl beats ALL bit-copier Programs 


=< 
m 
wn 


Floppy disks, hard disks and 

networks supported 

CopyControl is totally transparent to the user 
You can limit program use by no. of copies, 
no. of executions or date 

CopyControl works on all IBM compatibles 
Free demo disk available 


For Further Information Phone or Write to 


microcosm 


Microcosm Limited, 
17 Cranbrook Road, Bristol BS6 7BL 
Telephone: 0272-441230 Fax: 0272-427295 
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JPI 


the compiler Peovle 


Imagine a powerful integrated development environment 
common to whichever languages you choose, capable of 
supporting DOS, Windows or OS/2 development embodying 
the latest in OOP technology —it’s called TopSpeed from JPI. 
Its modular architecture opens up new realms of choice—simply 
slot-in languages, source libraries, and toolkits to build a 
development system that meets your needs. No redundant 
components — what you want is what you get! 


TopSpeed Environment - Multi-window editor, 
powerful Project system, Hypertext help (environment, all 
languages and library), debugger, syntax checker, menu or 
command line driven, EMS support, pop-up calc, 


plus... plus... DOS or OS/2 | £59 | 


TopSpeed TechKit — For power programming. Supports 
DOS DLLs, post mortem debugging, advanced overlay 

manager, TopSpeed assembler, .EXE file compressor, .OBJ 
file disassembler. Windows 3 resource compiler, /£59 | 


Windows 3 run-time libraries, plus... plus. . . 
TopSpeed C++ — makes C++ lean and mean Unique to JPI 
—TopSpeed Cis the only true AT&T 2.1 C++. 

TopSpeed C++ gives you SmartMethod® Linking which 
eliminates unreferenced classes, methods and even virtual 
methods —a real breakthrough for OOP programming. 


Includes short based pointers, concurrent tasking — 
even with DOS, plus... plus. . . DOS or OS/2 | £59 | 


Rogue C++ Class Library £59 DOS or OS/2 


TopSpeed C — the standard is enhanced. The only ANSI 
certified C. Generates compact high quality code for DOS, 
OS/ 2 and Windows 3. Includes run-time error checking, 
multi-threading, mixed memory models, links to 


C++, Modula-2 and Pascal, plus... —posoros/2 | £59 | 


TopSpeed Modula-2 - the world leading implementation 
of Modula-2. This strongly typed and highly structured 
language includes type safe conversion between objects, OOP 
extensions with true multiple inheritance, virtual 

pointers, based pointers, links to C, C++ and 


Pascal, plus. . . DOS or OS/2 | £59 | 


TopSpeed Pascal - the next generation. Power-up your 
Pascal, convert to TopSpeed, then tune it up with the hottest 
compiler for DOS, Extended Dos, OS/2, or Windows. ISO 
7185 conformant, Turbo to TopSpeed converter, ISO 
conformant arrays, dynamic strings, separate 

compilation units, OOP extensions plus much 


more... DOS or OS/2 | £59 | 


Library Source Kits available in all languages £59 


| NEW | TopSpeed DOS Extender 


Power-up your programming with JPI's own DOS Extender toolkit. Blast the 640K 
DOS barrier and supercharge your applications. Built-in disk based virtual memory 
management system for code and data, multi-tasking support using OS/2-like 
threads and a pre-emptive scheduler, OS/2 format DLLs supported, automatically 
loaded and unloaded on demand, plus. . . Royalty free. Full source code available. 


Call JPI on (0234) 267500 now for your free copy of the 
TopSpeed 1991 Compiler Catalogue 


TopSpeed products are available from: 
GreyMatter 0364-53499 - System Science 071-833-1022 
RTA 081-656-7333 
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3 The Mansards, Tavistock Street, Bedford MK40 2RX 
Fax: (0234) 217094 
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[eased 


Developing software on a LAN 
is fast, efficient, and dangerous. 


We make it safe, 
controllable and auditable. 


Experienced managers are 
rightly concerned about the 
integrity of LAN development 
environments. It’s too easy to 
overwrite or corrupt files. 

To safely develop on a LAN 
you need control over file 
changes, the ability to recover 
any module revision or system 
version, audit trails, and 
security that doesn’t 
hamper productivity. 

The solution: our LAN 
development environment, three 


control centre that simplifies 
access to any tool and provides 
industry strength editing. PVCS 
Professional Editor invokes 
PVCS Version Manager 
automatically. Just open modules 
to edit and the PVCS ° 
Version Manager window 
pops open. 
The final element in 
our LAN development 
environment is PVCS 
Configuration Builder - a 
sophisticated tool for 


tools that operate independently files and function security, automatically performing correct 
or snap together synergistically. automatic audit trail and detailed builds. A single command 

The primary element is project reports. recompiles all modules that have 
PVCS Version Manager which The best way to access PVCS been changed, re-links as 
provides version control and Version Manager is via our PVCS necessary, and produces a 
change management features, Professional Editor, an extensible correct, conforming program. 


it 
n'tlet These Special Offers 
th DOS or 0S2 DOS bre Os 
You B PVCS Version Manager oe i) 
# PVCS Configuration Builder : on oe 
Special offer prices are valid PVCS Professional Editor re : 
until 29th February 1992 Mainframe Gateway 


Software Express + Portmill House, Portmill Lane, Hitchin, Herts SG5 1DJ. Tel: 0462 422525 . 
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QEdit } 

y Grey Matter. £45 

(0364 53499) 

QBS Software : 

(0819944842) pata 

Software ConstructionCompany —- £39 

(0763 2441141) f ; 

Software Paradise £65 

(0222 877521) 

System Science £45 

(071 8331022) 


ainsi 


(Please note that all prices include p&p in the UK, but not VAT) 


ditors 
~ Ed Epsilon’ Brief. «PVCS 
i 190 £199 8195 
£109 - es PS 
- Bes fig. -Ss«105 
: e164 e191 Be 
i 175 £195 £189 


Figure 5 - Editor Prices 


You only have to run Brief’s qh macro to 
get help on a keyword/function at the cur- 
rent cursor position (see Figure 3). All of 
these features make Brief a brilliant editor, 
albeit with a hefty price-tag. 


PVCS Professional Editor 


As is the case with Epsilon and Brief, the 
PVCS Professional Editor (also called the 
Sage Professional Editor - SPE) is available 
under DOS and OS/2. 


n 


PE provides all the usual cursor controls 
and editing commands, although it doesn’t 
provide a column copy facility. There is a 
menu-bar which is activated with <CTRL> 
H, and a status bar that shows the filename. 
There is a Help system which can be acti- 
vated from the menu or by pressing <F10>. 
Ithough not context-sensitive, the online 
documentation is well presented. Help is 
arranged as two scrollable windows 
placed side-by-side. The leftmost win- 
dow contains a list of SPE’s commands. 
As you scroll down this window, the right 
window displays documentation on each 
topic. 


> 


There is a DOS window, like Epsilon’s, 
although it is not concurrent, The DOS win- 
dows uses only 24 KB of memory, so you 
should be able to run a compiler inside it. 
SPE will even run Windows Enhanced 
mode from within the DOS window. SPE 
also has a DOS shell, and it is able to 
compile a buffer from within the editor. 
On typing <ALT>F10, SPE pops up a win- 
dow containing an editable command- 
line. 


When compiling a buffer, SPE produces an 
error window and positions the cursor on 
the line containing the first error. It is 
possible to step through each error in turn, 
however SPE also enables you to quickly 
move toa particular error by scrolling down 
the error window. 


SPE provides built-in support for C. Itis able 
to produce C-style indentation and there is 
also a template facility. 


SPE can emulate Brief, vi, WordStar and 
MsWord and there is also a keyboard macro 
recorder. There’s a built-in ASCII table 
which lets you embed any ASCII character 
into your text by entering its ASCII value ( 
<ALT> + number from numerical key-pad 
is quicker if you know what you're doing). 
SPE is the only editor in this article that 
supports multiple overlapping windows. In 
addition to being able to create windows 
side-by-side, SPE allows windows to be 
placed on top of each other (see Figure 4). 
When you have several files opened at the 
same time, arranging each buffer as an 
overlapping window provides a far more 
intuitive way of editing multiple files than 
using a single window with a buffer-list. It 
also uses less screen space than a tiled-win- 
dow arrangement - at least you won't have 
to resort to excessive scrolling in order to 
do anything useful. 


Conclusion 


Choice of editor is almost always in- 
uenced by past experienced. If you're a 
die-hard fan of WordStar, I won't. waste 
space convincing you that there are better 
things available. However, most of the edi- 
tors in this article provide emulations for the 
more popular text editors (including Word- 
Star). So which one should you buy? Well, 
it all depends on what you intend to use it 
for. Qedit is an ideal replacement for MS 
DOS 5.0's edit - it provides far more 
functionality and it doesn’t crash. Epsilon 
offers a terse, UNIX-style environment and 
is available under UNIX as well as DOS and 
OS/2. Brief and SPE are similar products, 
targeted at the same market (ie C pro- 
grammer’s looking for a high-end profes- 
sional editor). My favourite? It has to be Ed. 
It offers many of the features found on Brie 
or SPE - but at almost half the price. 


EXE] 


QEdit, Epsilon, Brief and the PVCS Profes- 
sional Editor were supplied by System 
Science on 071 8331022. Ed was supplied 
by QBS on 081 9944842. 


Objects 
At Your Fingertips 


COCKING & DRURY 
SOFTWARE 


180 TOTTENHAM COURT ROAD, LONDON W1P 9LE 


071-436 9481 


OR FOR IMMEDIATE INFORMATION 
Use your fax phone to call 0865 727232 
to retrieve item 444333 
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MAYHEM 


oer £2/ 


Wasting our time 


Why do we buy computers and write programs? Jules thought he knew, but is not so sure. 


It was during an argument when the 
thought struck me, It was such a surprise 
that I conceded the point of the argument, 
in order to go away to consider it! The 
thought was this; computers don’t actually 
do anything. I don’t mean this in a literary 
or figurative sense, nor am I talking about 
abstract philosophy. I mean it quite literally, 
most computers could be dispensed with 
entirely with practically no loss. 


In principle, a computer is capable of al- 
most anything. To describe the machine as 
a bunch of switches, or a symbol manipu- 
lator, or an information filter, is to impose 
restrictions on it. Of course it is all of those 
things, but the immense amplification that 
computers can bring to bear make such 
descriptions simplistic to the point of being 
misleading. We can take this splendid ma- 
chine, and we can impose any 
concept on it we wish, and 
the computer will be ca- 
pable of responding to the 
imposition and offering 
its user a clean, effec- 
tive metaphor. 


Most programs 
which have been 
written use the 
same metaphor - 
paper. I suppose 
this makes sense - 
everyone who can 
type can read, and 
most of what we read 
is made of paper. 
When computers 
were first manufactured 
in the ’50s they were set 
to work automating jobs 
which were being done 
perfectly adequately by 
armies of clerks, albeit 
slowly. Nobody ques- 
tioned why the armies of 
clerks were necess- 
ary, and nobody 
questioned that 

the same work 
needed doing on 
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the computer. It wasn’t until Marks and 
Spencer worked out how much it cost to 
misfile a piece of paper that they decided 
they could throw some of it out - 120 tons 
of it in fact! 


As long as computers are automating work 
that originated on paper, all the old prob- 
lems caused by paper are still 

around. The cost of mis- 
filing information 
hasn’t changed, the 
cost of 


getting the data onto the forms in the com- 
puter hasn’t changed, and the cost of some- 
one wading through acres of figures hasn’t 
changed either. The cost of processing the 
data has decreased, of course, which has 
permitted yet more paper to be produced. 
Tasks which used to use paper out of 

necessity, like fin- 


ance, CAD, and graphics, instead of being 
freed by computers, have been compu- 
terised monolithically, paper and all. Now, 
the wonderful world of Windows is open- 
ing up before us - here is computing like 
you've never seen it before. Ha! What is the 
central metaphor of windowing systems? 
Paper, that’s what! 


‘Aha!’ I hear you say, ‘but most computers 
are made for business, and business needs 
accurate records, doesn’t it? Paper is good 
for that!’ Well, yes and no. Most people who 
run businesses do so because they want to 
build something, not because they like 
paperwork. I have yet to meet an executive 
who doesn’t complain about his paper- 
work, no matter how many computers and 
secretaries he is given. The only reason an 
exec needs to know his company’s turn- 
over correct to three pence is because the 
taxman demands it, but why does the tax- 
man 


need such precision? The exec doesn’t 
work out his buying strategy to the nearest 
three pence, does he? Why isn’t 1% preci- 
sion good enough all round? 


Consider, as an alternative, the spectacular 
strides which have been made in musical 
instrument design. One can get cheap ma- 
chines which can synthesise practically any 
noise one can imagine, and the proof is that 
often synthetic instruments sound better 
than their acoustic counterparts. There are 
computers into which you can hum a tune, 
and they can, in real time, figure out har- 
monies and rhythms to back you up. Al- 
most every band now comprises a guitarist, 
a drummer, and a programmer! Further- 
more, these machines are usable by musi- 
cians - their buttons and knobs are 
annotated in terms a musician can under- 
stand, 


For another example, let us pursue the idea 
of removing paper from a pro- 

cess which tradition- 

ally demands 
reams of it - 
referenda, 
National 
Insurance 
cards 


Mayhem 


are now plastic, with a magnetic stripe on 
the back. Suppose every post office in the 
country is equipped with a terminal, into 
which you insert your card, and are shown 
a list of the issues being debated in parlia- 
ment. Instead of politicians having to guess 
whether we want to be European, or 
whether we wanta bill of rights, or whether 
we want to re-introduce Sunday trading, we 
can tell them. The computers could keep a 
record of what issues a citizen has voted on 
(though probably not the vote he has cast) 
toavoid repetitions. We could build the first 
real democracy the world has ever seen! 


This is looking good, let’s follow it further. 
One could subscribe from one’s telephone, 
so it is not necessary to stand in queues. 
Instead of seeing politicians rubbishing 
each other on the telly, we could augment 
the system with statements of position from 
interested parties. One could even contrib- 
ute one’s own statement, which would 
become more easily accessible as more 
people looked at it. A citizen would be able 
to introduce his own bill, which again, 
would work its way up the system toa place 
of prominence if interest in it demanded. 
Parliament would then have to follow the 
wishes of the people, or else give a good 
reason why it won't. 


We need representatives at the moment, 
because calling a referendum - the paper, 
the manpower, and the officialdom - all 
costs money, Here is a system which 
could slash those costs, and im- 
prove the service to boot, be- 
cause what referenda are for, in 
the final analysis, is to take deci- 
sions. The engineering is almost 
trivial, and the technology is tried 
and tested. 


Returning to my original assertion, it 
seems to me we are wasting some 
wonderful technology. Computers 

are not new (they we first built 

in 1943) and are largely mature 

by now. We have enough 
knowledge and skill now to 
build things to pretty good pre- 
cision (which is good enough), 
and the only thing which is block- 
ing the technology from being really 

useful is conservatism and lack of im- 

agination. I’m afraid most of us are spin- 

ning our wheels. 


EXE) 


Jules May is a consultant who feels naked 
without a computer in front of him, and 
is currently trying to find the time to 
write lots of new programs. He 
can be contacted on 0707 
44185, or on CIX as jules. 
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WIM, LANE STUMP’S C++ DIARY 7777 


C++ DLLs 


Segments From Hell 


Once you've navigated the treacherous waters of the memory 
management ‘River Styx’, you too can give your DLLs a touch of class. 
Laine Stump puts a C++ class library into a Windows DLL. 


Windows Dynamic Link Libraries (DLLs) 
seem to be the perfect package for imple- 
menting and distributing class libraries; 
rather than bloating all those EXE files 
with the same library code, you can build 
a DLL and call the same code from any 
EXE. This not only saves space on disk, it 
(more importantly) saves memory at run- 
time. 


But putting your handcrafted classes into a 
. isn’t as simple as just recompiling. 
Besides making sure that the proper names 
are exported from the DLL and imported to 
he application (APP), you must take care 
to avoid problems with the ‘Dual Heap’ 
structure of the DLL-APP pair - not only are 
the code of the DLL and APP in separate 
segments, they each have a separate auto- 
matic data segment (heap, or DS) as well. 
(Figure 1 shows a simplistic picture of the 
segments of a DLL and two APPs; note that 
an APP’s stack is in the same segment as its 
heap, while a DLL has no stack - it borrows 
the stack of the calling APP). 


With all these complications, it’s not diffi- 
cult to construct a program where inherit 
ance, virtual functions, and static data 
members, (among other features) don’t 
work at all properly. 


As usual, the explanations and examples 
included with compiler packages do not 
exercise all these capabilities (BC++'s DLL 
example had a class, but did not derive any 
other class from it; Zortech's DLL example 
was written ins ht C), so I set to explore 
the subject by creating my own example 
program, with APP classes derived from 
DLL classes, static data members, and vir- 
tual functions called both from the APP and 
from the DLL. Along the way, I recorded the 
pitfalls, problems, hints, and solutions I 
found, and present them here so that 
the rest of you won't have to go through 
the same torture (fun torture though it 
was). 
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Piece 


The example I will use to help in my expla- 
nations is a simple class called Piece. A 
Piece is any object that can be displayed 
in a window. The base class has functions 
for hiding, showing, and moving a Piece, 
as well as a virtual function called Paint () 
which is redefined for each derived class. 
Piece resides in a DLL, along with a 
derived class called cRectangle. 
oPP, PIECE. These 
$3, 4and 5. 


The main program, PieceTst (see Figures 6 
and 7), derives a second class, CEllipse, 
from Piece, and creates three cRec- 
tangles andtwo cEllipses which it 
stores in an array of Piece *,WndProc 
works together with members of Piece to 
allow the user to drag these pieces around 
the screen with the mouse, Except for 
Piece and its derivatives, the rest of the 
program is in standard C style, as I didn’t 
want to clutter up the discussion with more 
than one set of classes. Ideally the Pieces 
would be stored in some type of Dis- 
playList, and the windows and even 
the application itself would also be instan- 


PP, PIECE.H, PIEC 
LIB (created by running IMPLIB 
2CE.DLL) and PIECETST.RES. 


I developed and tested Piece and Pie- 
ceTst using Zortech C++ v3.0r4 (ZTC); 
the necessary commands to compile are 
in Figure 2 (M.BAT). Only small changes 
should be needed for BC++ v3.0 - differ- 
ent compiler switches and a slightly dif- 
ferent method of exporting functions 
from the DLL. 


EXPORTing from the DLL 


The names of all functions in a DLL which 
will be called from APPs and other DLLs 
must be available for load-time linking. 
Windows calls this ‘exporting’ the function. 
The client program then ‘imports’ the func- 
tion to use it. 


export a function in either of two 
: list it in the EXPORTS section of the 
DLL's .DEF file, or tag the function defini- 
tion with the keyword _export. The for- 
mer method makes for impressive looking 
lists, but can be quite awkward, as the name 


ces of C++ classes. Ileave those as exercises | listed in the .DEF file must be the function’s 
for the hapless reader. mangled name. 
APP-1 CS DLL CS APP-2 CS 
APP-1 DS DLL DS APP-2 DS 
stack| DLL Data stac| 
Data Data 


the stack of whichever APP has called it. 


Note that when executing in APP-1 CS, DS must always point to APP-1's data. The same 
holds for the DLL and APP-2. While each APP sets its SS to the APP’s DS, the DLL uses 


Figure 1 - Segments of two APPs and a DLL. 


BORLAND 


THE SOFTWARE CONSTRUCTION 


MKS Programmer's Platform 
MKS Toolkit 


9: Instant Replay III 


 QRAM 
Turbo EMS 


Borland C++ £199 PolyAWK Toolkit 

C++/App. Framework £269 SpellCode 

Turbo C++ 2nd. Edition £49 TRANSLATOR 

Turbo C++/Turbo Vision £69 | pastoc 

Turbo Debugger & Tools £85 | BAS C Commercial 

Turbo Pascal v.6.0 £69 | CodeTranslator NEW 

Pascal Professional £129 | FOR_C 

Pascal for Windows £99 | Pascal to C Translator 

ObjectVision £79 EDITORS 

Paradox 3.5 £335 | BRIEF for DOS & OS/2 

Paradox Multi Pack £399 | BRIEF upgrade 

Paradox Engine £199 | BRIEF with dBRIEF 

Paradox SQL Link £215 pees 

UK AUTHORISED 
DATABASES Microsoft 

Advanced Revelation Cae aa 
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Tused the second method in Piece. Notice 
that each function of the class is preceded 
by the word EXPORT (#defined to be 
_export if compiling for a DLL, or null if 
compiling for a normal static link). The 
compiler and linker work together to make 
the mangled name of these functions avail- 
able for export. Much easier. 


You will notice that two types of member 
functions are notexported with export: 
inline functions and destructors. Inline 
functions are not listed as export be- 
cause their code does not exist in the DLL 
anyway; the function isn’t imported, but 
merely inserted into the APP anywhere it is 
‘called’. 


I couldn’t use _export on destructors 
because of a bug in the current release of 
ZTC which flags such attempts as an error. 
Until Zortech makes another release, we're 
stuck figuring out the name of the destruc- 
tor and listing it in EXPORTS in the .DEF file 
(see PIECETST.DEF). Find this name by 
looking in the linker’s .MAP file - destruc- 
tors always have the name 


dt__#classnameFv 


where # is the number of characters in the 
class name. 


Seasoned Windows programmers should 
note that the requirement of exporting de- 
structors via the .DEF file means we can’t 
use the ‘reduced prolog’ compiler switch 
(-W2) as it only allows functions marked 
with export inthe source to actually be 
exported. I used -W1 (full prolog for all far 
unctions) in my tests. 


No data members are exported in any man- 
ner, as instance data can be located via the 
this pointer, while static data cannot be 
accessed directly from outside the DLL any- 
way, as we'll see momentarily. 


IMPORTing to the APP 


Once a class’s member functions have been 
exported, the APP must import them in 
order to use the class. There are two ways 
of accomplishing this as well: listing the 
desired function names in the IMPORTS 
section of the APP’s .DEF file (in mangled 
form, of course), or creating an ‘Import 
Library’ from the DLL. As we all hate dealing 
with mangled member function names, we 
will again choose the second method, 
which turns out to be simple to the point of 
disgusting - run IMPLIB on the DLL, then 
add the produced .LIB file to the compile 
command for the APP. Don't forget to rerun 
IMPLIB any time you add or remove a func- 
tion from the DLL. 


Memory Model 


Windows is a weird duck in terms of mem- 
ory models. The freewheeling cauldron of 
moveable data segments and discardable 
code segments is frightening if you stop to 
think. A remnant of its real mode past, 
Windows attempts to do ‘big boy’ memory 
management tasks purely in software. For 
this to work correctly, well behaved pro- 
grams should allow as many of their seg- 
ments as possible to be moved at almost 
any instant. You can’t allow this and have 
far pointers at the same time, hence the 
popularity of Medium model (far code, 


zte -mlw -W1 -o -D_D 
implib piece.lib piec 


piece piece.def piecetst.res 
1 


ztc -ml -W3 -o piecetst piecetst.def piecetst.res piece.1lib 


Figure 2 - M.BAT - compile command for PIECE and PIECETST 


#include <windows.h> 


#ifdef DLL _ 

#define EXPORT export 
felse 

#define EXPORT 

fendif 


enum TIMES (IMMED, DELAY}; 


class Piece 
( // Graphics "Piece" base class 
7/ static member data 
static HWND hCurWnd; // cur. window 
static HDC hpc; // device context 
static PRECT Inv; // invalid region 
protected: 
// instance member data 
HWND h¥ind; // owner window 
RECT bnd; // bounding rectangle 
DWORD color; 
WORD visible; 


// “real” paint - defined by all, 

// ut only called by other members 

virtual void EXPORT Paint() = 0; 
public: 

static void EXPORT 


SetContext (HWND hw, HDC h, 
HDC EXPORT GethDC(); 


PRECT i); 


EXPORT Piece (HWND hw, 

int x, int y, DWORD c); 
virtual ~Piece(); 
virtual void EXPORT ReDraw(); 


int GetXx() { return bnd.left; } 

int GetY() ( return bnd.top; } 

int EXPORT Contains(int x, int y); 

WORD EXPORT Hide (WORD when 

WORD EXPORT Show (WORD when 

void EXPORT MoveAbs(int x, int y 
Me 


// cRectangle - DLL class from Piece 

class cRectangle : public Piece 

it 

public: 

EXPORT cRectangle(HWND hw, 

int x, int y, int dx, int dy, 

DWORD color); 

~cRectangle(); 

void EXPORT Paint (); 

Me 


Figure 3 - 
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near data) in Windows programs. Large 
model is allowed, you just have to lock all 
your data segments in place (and face 
lynching by the Charles Petzold fan club). 


Unfortunately, if you want classes ina DLL, 
you must compile everything with Large 
model. I first resisted the idea, but when I 
learned that even the BC++ OWL library 
DLLs can only be used with Large model, I 
resigned myself to fate, and comforted my 
soul by repeatedly chanting the final sec- 
tion of the Memory Management chapter in 
Petzold’s Windows book, ignoring the part 
earlier on that referred to Large programs 
as ‘pigs’. 


Although there are many, I will tell you two 
reasons why any program having classes in 
a DLL must be compiled as Large model 
(sorry, Charlie). The cause of both is that 
the DS of the APP and the DLL are separate, 
and an object could be located in either 
one: 


1) To allow access to objects in either DS, 
the this pointer of all member functions 
must be far, It is reasonable for a member 
function to call Windows, and every Win- 
dows programmer knows that Windows is 
free to move any nonlocked segments any 
time Windows is called. The result is that 
the this pointer could be invalid upon 
return from the call. Besides, Zortech only 
allows this to be far in Compact and 
Large model (you can’t explicitly create a 
far object in Medium or Small model). 


2) Each object has a pointer to a Virtual 
Method Table (VMT) which is usually in the 
DS of the program which created the object. 
This pointer is used to call the proper virtual 
function for an object. As long as you are 
calling from the same ‘side’ of the DLL-APP 
boundary which allocated the space for the 
object, the VMT can be found with a near 
pointer (eg calling ReD raw () fora cE1- 
lipse from within the APP), But, if you 
are calling a virtual function for an object 
that was allocated from the other side, you 
need a far pointer to find the VMT (eg 
calling ReDraw() for a cRectangle 
from the APP, or calling Paint () fora 
cE11lipse fromthe DLL), Again ZTC only 
allows far VMT pointers when compiling 
with far data models (Compact and Large). 


BC++ goes even further - VMT pointers are 
near in all models unless you 1) set a com- 
piler option to put them in the code seg- 
ment, or 2) declare the class as huge. 
Option 1) requires that code segments, like 
data, be locked and nondiscardable, while 
option 2) would not work properly with 
BC++ v2.0 (I couldn’t derive a huge class 
from an _export base class). 
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Happily, if you ran Windows in Standard 
(286 protected) or Enhanced (386 pro- 
tected) mode, even ‘locked’ segments are 
moveable. After moving the data to a new 
segment, Windows just fixes up the selector 
table so that the same selector points to the 
new segment. Your program can use far 
pointers with wild abandon, while Win- 
dows efficiently scoots memory around. 


Static Data Members 


Remember that the DLL has a different DS 
from the APP. Static data of the base class 
is putin the DLL’s DS. In order to access this 
data, you must be executing in the DLL (the 
DS register is set to point to the DLL’s DS by 
the DLL function's prolog). Don’t try to use 
static members in inline functions, as DS 
will be incorrect. Also, make sure that the 
user of your class can’t do it either. The only 
way to guarantee this is to make all the static 
data private to the base class, and write 
functions to get and set the values, That's 
what I’ve done for Piece - all three static 
members are private, and I’ve defined func- 
tions for manipulating them (SetCon- 
text (), GethDC () ). Remember, these 
functions can’t be inline! 


Member Functions 


Functions that access only instance data can 
safely be inlined. Get X () and Get Y () 
are examples of such functions, 


Any member function that requires access 
to data in the DLL's DS should not be in- 
lined, though. This includes functions 
which call the standard C library, or use any 
global data declared in the DLL. 


Although you may think that your construc- 
tors and destructors only use instance data, 
they actually have secret implied calls to 
new and delete. Rather than calling 
new directly when you allocate an object 
dynamically, both ZTC and BC++ generate 
code which calls the constructor with a 
NULL this pointer. The constructor 
checks for this condition, and accordingly 
calls new if necessary. When a destructor 
is called, a flag is set if the data was dynami- 
cally allocated. If so, delete is called. If 
the constructor and destructor are defined 
in the DLL, the object will live in the DLL’s 
heap, even though it was created by the 
APP. , 


Therefore, either all or (preferably) none of 
the constructors and destructors should be 
inline; they should all execute either in the 
DLL or in the APP to avoid situations where 
memory is allocated from one heap and 
released to another. Piece defines all 
constructors and destructors as non-inline. 


Which Heap? 


As mentioned above, every call to new 
from a constructor defined in the DLL gets 
memory from the DLL's heap. If several 
programs are using the DLL, it could ex- 
haust the local heap (64 KB) quickly. To 
allow allocating more than 64 KB, you can 
redefine new and delete in the DLL, as 
I have at the top of PIECE.CPP. I simply 
defined new to allocate a fixed block of 
memory from Windows’ Global Heap. 
Using the Global Heap is slower than the 


y 
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normal Local Heap, but you can allocate as 
much memory as you like, up to the limit 
of your RAM, or your swap file size. 


I also redefined new and delete in the 
APP (PIECETST.CPP) to use the standard 
Windows Local Heap. The ZTC libraries do 
their own heap management in Compact 
and Large models under Windows, and I 
encountered bugs when running multiple 
instances of the same program using Zor- 
tech’s heap management. Redefining new 
and delete solved the problem. 


// #define _DLL_ // to use as DLL 
include "Piece.h" // includes windows.h 


fifdef _ DLL_ 
VILTLLTTEUTATTUATATALTT AAA AAA , 
int FAR PA: L LibMain 
( HANDLE hInst, WORD wDS, 
WORD wHeapSz, LPSTR lpszCL ) 
( return 1; ) 


int FAR PASCAL WEP ( int bs 
{ return 1; ) 
CU , 
#include dlib.h> // to define size_t 
// use Windows’ Global Heap 
void * operator new(size_t siz) 
( 
return (void*) 
MAKELONG (0, GlobalAlloc (GPR, siz)); 
) 
void operator delete (void *obj) 
( 
GlobalFree( (GLOBALHANDLE 
LOWORD ( (LONG) obj) ); 


stemExit ) 


} 

LELELLLLAELLTLALTAT LTA TATA ATTA 
endif 

HWND Piece::hCurWnd = 0; 

HDC Piec! DC = OF 

PRECT Piece::Inv = 0; 


void EXPORT Piece: :SetContext 
(HWND hw, HDC h, PRECT i) 
{ // set static data for Painting 
hCurWnd = hw; 
hoc = hy 
Inv = i; 


) 


// short, but *must not* be inline 
HDC EXPORT Piece: :GethDC () 
{ return hdc; } 


EXPORT Piece::Piece(HWND hw, int x, 
int y, DWORD c) 


{ 
hWnd = hw; 
bnd.left = x; 
color = 
visible = 0; 


} 


bnd.top = y? 


Piece exported by DEF file 
Piece: :~Piece() 
visible) Hide (DELAY); ) 


void EXPORT Piece: :ReDraw( 
{ // call paint if in Inv 
RECT r; 
if ( (hCurlind == hWnd) 4&& visible &6 
IntersectRect (&r, &bnd, Inv) ) 
{ // set brush, paint, reset brush 
HBRUSH hb, ohb; 
hb = CreateSolidBrush (color) ; 
ohb = SelectObject (hDC, hb); 
Paint(); // virtual, possibly in APP 


SelectObject (nDC, ohb); 
DeleteObject (hb) ; 
} 


} 


int EXPORT Piece: :Contai 
{ // checks if (x,y) 
POINT p; p.x = x7 Pey = 
return PtInRect (ébnd, p); 
} 


s(int x, int y) 
inside Piece 


WORD EXPORT Piece::Hide (WORD when) 
{ // hide this piece 

WORD was = visible; 

visible = 0; 

InvalidateRect (hWnd, &bnd, 1); 

if (when == IMMED) 

UpdateWindow (hWnd) ; 
return was; 


) 


WORD EXPORT Piec 
{ // unhide t 
WORD was = visible; 
visible = 1; 
InvalidateRect (hWnd, &bnd, 0); 
if (when == IMMED) 
UpdateWindow (hind) 7 
return was; 


when) 


id EXPORT Piec 


:MoveAbs (int x, int y) 
per left of piece to x,y 
ble = Hide (IMMED) ; 
bnd.right = x+(bnd.right ~bnd.left); 
bnd. bottom = y+ (bnd,bottom-bnd. top) ; 

i bnd.top = y7 

sible) Show (DELAY); 


TULA TAA AAA 
// ** member functions of cRectangle 


EXPORT cRectangle::cRectangle 
(HWND hw, int x, int y 
int int dy, DWORD color 
: Piece(hw, x, y, color 
{ // set rectangle to be drawn 
bnd.right = x + dx; 
bnd.bottom = y + dy; 
Show (DELAY) + 
) 


// declare destructor to ensure delete 
// is called from proper context 
// (inside DLL, not APP) 


cRectangle::~cRectangle() {} 


void EXPORT cRectangle: :Paint () 
(// paint this Rectangle 
// color has been set by ReDraw() 


Rectangle (GethDC(), bnd.left, bnd.top, 
bnd. right, bnd. bottom) ; 


Figure 4 - PIECE.CPP 


LIBRARY PIECE 
DESCRIPTION ‘DLL for Piece class’ 
EXETYPE WINDOWS 

CODE PRELOAD MOVEABLE DISCARDABLE. 


DATA PRELOAD SINGLE FIXED 
HEAPSIZE 1024 
EXPORTS dt__5PieceFv 


‘dt__10cRectangleFy 


Figure 5 - PIECE.DEF 
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Remember, the location of object alloca- 
tion is decided by where the code of the 
constructor and destructor reside, NOT 
where you call new and delete. Since 
cRectangle’s constructor and de- 
structor are in the DLL, cRectangles 
are allocated on the Global Heap, while 
cE11ipses (constructor and destructor 
in the APP) are allocated on the APP’s 
Local Heap. 


Virtual Functions and DS 


Here’s where it starts to get fun. Remember 
that when executing in the DLL, DS must be 
set to the DLL’s DS, while in the APP it must 
be set to the APP’s DS. As long as you don’t 
cross the DLL-APP boundary, DS will be set 
properly, but any function that can be 
called from the other side (APP->DLL or 
DLL->APP) must have instructions to save 


// PieceTst.cpp ~ test the Piece class 
// and show how it should be used. 


#include "piece.h" // includes windows.h 


PILTATTA TAT T AA T A AAAAAAAAAAA. 

#include <stdlib.h> // defines size_t 

// use Windows’ Local Heap 

void * operator new(size_t siz) 

( 

return (void*) (void NEAR*) 
LocalAlloc(LPTR, siz); 


) 
void operator delete(yoid *ob3) 
{ 

LocalFree( (LOCALHANDLE) 
LOWORD (obj) )i 


PALLTIUTT TTA 
- APP class from 


FALLTTAAAT TT 
** cEllipse 


MIA 
Piece 


class cEllipse : 
{ 
public: 

cEllipse(HWND hw, int x, int y, 

int dx, int dy, DWORD color); 

Ellipse (); 

void Paint (): 
Mv 


public Piece 


cEllipse 


Ellipse(HWND hw, int x, int y, 
int dx, int dy, DWORD color) 
: Piece(hw, x, y, color) 
( // set rectangle to be drawn 
bnd, right x + dx; 
bnd.bottom = y + dy; 
Show (DELAY) ; 


Piece () 


only* from Piece: :ReDraw() 
Ellipse (GethDC(), bnd.left, bnd.top, 
bnd,right, bnd.bottom) ; 


ITI TULTTTTLLELT LT 
Piece *pieces(5); // array of 5 Pieces 
char szAppName[] = "PieceTest"; 
long FAR PASCAL _export 


WndPro 


WND, WORD, WORD, LONG); 


WinMain (HANDLE hInst, HANDLE hPreviInst, 
LPSTR lpszCmdbine, int nCmdShow) 


CLASS 
if (!hPrevInst) 
{ 
we.style = CS_HREDRAW | CS_VREDRAW? 
we.lpfniindProc = WndProc; 
= 07 
= 0; 
= hInsts 
LoadIcon (NULL, 
IDI_APPLICATION) + 
LoadCursor (NULL, 
IDC_ARROW) ; 
GetStockObject 
BRUSH) + 


Instance 
shIcon = 


we. hCursor = 


we.hbrBackground = 


we.lpszMenuName = NUL! 

we. lpszClassName 

RegisterClass (&we) 7 
) 


hind = CreateWindow(szAppName, 
"Testing Pieces", 
WS_OVERLAPPEDWINDOW, 
CW_USEDEFAULT, CW_USEDEFAULT, 
CW_USEDEFAULT, CW_USEDEFAULT, 
NULL, NULL, hInst, NULL a 
ShowWindow (hind, nCmdShow) + 
UpdateWindow (hind) ¢ 


while (GetMessage(émsg, NULL, 0, 0)) 
{ 
Trans lateMessage (msg) ; 
DispatchMessage (6msq) 7 
} 
return msg.wParam; 
) 
long FAR PASCAL _export 
WndProc (HWND hWnd, WORD msg, 
WORD wParam, LONG lParam) 


int ct; 
static curpe = -1, npe = 5; 
stat fs, yofs; 


switch (msg) 


WM_CREATE: 


pieces(0) = new cRectangle (hWnd, 
20, 20, 150, 150, RGB(255,0,0)); 
pieces(1) = new cRectangle (hWnd, 


40, 40, 80, 50, RGB(0,0,255))7 
pieces (2) = new cRectangle (hWnd, 
70, 95, 120, 180, RGB(25,10,50))+ 
pieces(3] + new cEllipse (hWnd, 
200,100, 60, 90, RGB(255,255,0))+ 
pieces[4) = new cEllipse (hind, 
150,30, 120, 100,RGB(0, 255, 255) ) 
return 0; 


case WM_PAINT: 
PAINTSTRUCT ps; 
HDC hDC = BeginPaint (hWnd, &ps); 
xt (hWnd, hDC, 


for 
pieces (ct ]->ReDraw(); 
EndPaint (hWnd, &ps); 


case WM_MOUSEMOVE: 
if ((wParam & MK_LBUTTON) 
&& (curpe != -1)) 
pieces [curpe] ->MoveAbs ( 
LOWORD (1Param)-xofs, 
HIWORD (1Param)-yofs) ; 


return 0; 


= -1; 

npc-1; ct >= 0; ct--) 

if (pieces (ct) ->Contains ( 
LOWORD (1Param) , 
HIWORD (1Param) )) 


curpe = ct; 
xofs = LOWORD(1Param) 
- pieces (ct]->GetX()7 
yofs = HIWORD(1Param) 
- pieces(ct]->GetY¥(); 
break; 
} 
return 0; 


case WM_RBUTTONDOWN: 
SendMessage (hind, WM_LBUTTONDOWN, 


wParam, lParam); 


if (curpe != -1) 
{ 
npe=-; 
delete pieces [curpe]; 
for (ct = curpe; ct < npc; ct++) 


pieces[ct] = pieces{ct+1]; 
curpe = -1; 

) 

return 0} 


case WM_DESTROY: 
for (ct = 0; ct < npe; ct++) 
delete pieces(ct]; 
PostQuitMessage (0); 
return 0; 
} // switch (msg) 
return DefWindowProc (hind, msg, 


wParam, lParam); 


Figure 6 - PIECETST.CPP 
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C++ DLLs 


the calling DS and point DS to the called 
procedure’s heap. In terms of Figure 1, any 
crossing of the borders between CSes must 
be accompanied by an appropriate change 
to DS. Crossing from APP->DLL happens 
any time a base class member function is 
called, DLL->APP occurs when a function 
in the DLL calls a virtual function of a 
derived class (eg Piece: :ReDraw () 
calls CELlipse::Paint ()). 


DLL functions have code in the function 
prolog which saves the DS of the caller and 
sets DS to point to the DLL: 


mov AX, xxxx ;DLL’s DS 
push DS 
mov DS, AX 


Before any statements of the DLL function 
are executed, DS is pointed to the DLL's 
heap. As there is only onc instance of any 
DLL (multiple APPs use the same DLL in- 
stance), this method of loading a constant 
value works. 


The same method won't work for an APP, 
though, as there can be many instances of 
the same APP, and each has it’s own Local 
Heap (and DS). Therefore DS can’t be 
loaded by a prolog to the function as was 
done in the DLL. Instead, each instance of 
an APP function which is exported (callable 
from outside the APP), is called through an 
‘Instance Thunk’: 


mov AX, this instance DS 
jmp xxxx:yyyy; jump to function 


XXXX 


The function begins by pushing DS, and 
setting DS to the value passed in AX, Each 
instance of an APP has it’s own Instance 
Thunks. 


The problem is that except for Window- 
Procs, Instance Thunks are not created 
automatically, they must be created by 
the programmer calling the Windows 
function MakeProcInstance(), 
which returns a pointer to the Instance 
Thunk, used thereafter to call the func- 
tion. As the programmer doesn’t have di- 
rect access to the Virtual Method Table 
(containing pointers to the virtual func- 
tions), this method of fixing DS is imprac- 
tical for virtual functions. 


All is not lost, however, if you remember 
that the Stack Segment (SS) is always point- 
ing to the current APP’s stack, even when 
you are executing in the DLL. By definition, 
an APP’s SS is equivalent to its DS. When a 
function in the APP (in particular, a virtual 
member function) is called from the DLL, 
its prolog can simply load DS from SS (after 
saving the calling DS, of course): 
(Continued on page 66) 


Microsoft Press 


Essential books for Windows programmers 


THE MICROSOFT VISUAL BASIC WORKSHOP 
by John Clark Craig 

The book that addresses the hottest issue in computing today - how to 
create full-featured Windows applications. This book-disk package 


VISUAL BASIC 
WORKSHOP: 


<a 


explains Visual Basic concepts, techniques and tricks, and features a 
collection of 41 re-usable tools and application examples that can be 
incorporated into your Windows programming projects. The disk 


contains both source-code and executable files. 


Paperback 350 pages £29.95 inc VAT 
ISBN 1-55615-386-4 


PROGRAMMING WINDOWS —>>>>>00sG 
by Charles Petzold WINDOWS 

The best-selling, clear and authoritative book that no Windows 
programmer can afford to be without. It is packed with indispensable il 
reference data, tested programming advice, and new sample programs. 
“Just take it as a given - if you’re going to program for Windows, buy 
this book. It will pay for itself in a matter of hours.” Computer Language 


Paperback 900 pages £27.95 ISBN 1-55615-264-7 


CHARLES PETZOLD 


MICROSOFT WINDOWS 3 DEVELOPER’S 
WORKSHOP 
WINDOWS 3 by Richard Wilton 


Developer's Workshop 


“After you’ve nailed down the basics, Rick Wilton’s valuable book will 
surely sharpen your Windows programming skills.” Charles Petzold 

An example-packed resource, this book provides detailed discussions of 
some of the central and most complex issues faced by every Windows 
programmer. Topics include: Debugging, DLL, Custom Controls, 
Windows and Objects, DDE. In addition, Wilton offers practical 
approaches to programming puzzles. 


Paperback 272 pages £22.95 ISBN 1-55615-244-2 


Available from all good bookshops CIRCLE NO. 481 
and via mail order from: 


The PC BookShop Tel 071 831 0022 Fax 071 831 0443 


mov AX, SS ;APP’s DS 
push DS 
mov DS, AX 


In contrast to loading DS with a constant 
value (as done for DLLs), loading from SS 
will work with multiple instances ofan APP. 


Luckily, ZTC and BC++ both have a com- 
piler switch that causes all far functions to 
load DS from SS as shown above, Use -W3 
for ZTC, and -WS for BC++. As all far func- 
tions are considered exportable when 
using this switch, you don’t have to mark 
the functions as_export. 


Review 


n brief, to put your class into a Windows 
DLL: 


Figure 7 - PIECETST.DEF 


1) Use Large Memory Model - declare 
all Data Segments as FIXED. 

2) Declare nonline members 
as export, 

3) Put destructors’ mangled names in 
EXPORTS of the DLL's .DEF file. 

4) Do notaccess static data or library 
functions from inline functions. 

5) Make all static data members private 
to the DLL, and give access to them 
through (non-inline) member 
Functions if necessary. 

6) Do not make constructors or 
destructors inline. 

7) Redefine new and delete in the 
DLL if you will need >64 KB of 
space for objects of classes defined 
in the DLL. 

8) Compile the APP with -W3 (ZTC) 
or -WS (BC++) so that DS is loaded 
from SS on entry to all far functions. 

9) Don’t forget the fire extinguisher. 

Conclusion 

Although a price must be paid to put C++ 

classes into Windows DLLs, notably the 

requirement of using Large model and the 
necessity to be careful about static data and 
virtual functions, itis worth the expense, EXE 


C++ DLLs 


files are smaller, and memory usage is poten- 
tially less (if several APPs use the same DLL). 


Due to data segments being locked, pro- 
grams which use these DLLs will run in a 
degraded state in Real mode Windows, but 
will show little performance penalty in 
Standard and Enhanced mode. 


(Exe) 


Laine Stump has been threatening to get 
into Windows programuning for at least two 
years, but bas just managed to get off bis 
duff in the last six months. His desk is now 
several inches deep in purple and blue ma- 
nuals, dirty dishes, and balf-eaten cheese 
sandwiches. 


As usual, he can be reached via the PC Tech 
BBS at (0101-612-345-4056, evenings, US 
time) or by post at: Bilkent University, 
Lojmanlari 3/9, 06533 Bilkent / Ankara, 
TURKEY. 


The code accompanying this article is avail- 
able on disk. Send a blank formatted floppy 
disk to the Editor, following the instructions 
given on Page 1, column 1, Mark your 
envelopes ‘CPPDLL’. 


CLIPPER ADD-ON SOFTWARE 


QBS Software Limited specialiese in providing the best add-on libraries and utilities for Clipper. We distribute 
throughout Europe, providing local support centres in France, Germany, Italy and elsewhere through our agents. 


Flexfile 
Fast Text Search 
Dr Switch 


Variable length fields 
Advanced Text Search Technology 


SpellCode 
The Engine 
Biton 


Spell Checker 
Linkable Spell Checker 


FUNCky 
Blinker 
Netlib 
SilverComm 
GFORCE 
Silverpaint 
SubNtx() 
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Create RAM resident applications 
General Function Library Scripton 
Overlay) 
Expert help 
CL Text 
SilverClip 
BabelFish 
ED 


All trademarks recognised. 


Dynamic Overlay Linker 
Networking Library 
Communications Library 

Fast graphical interface for Clipper 
Graphics Library 

Filtering Utility 


Oracle Library 

Postscript Library 

Memory Roll Out Utility 

The drop-in replacement for Norton Guides 
Word Processing for Clipper 

Professional Clipper Communications library 
Paradox database driver for Clipper 

The Programmer’ s Editor 


90 days technical support by phone or fax provided on all systems 
For further information, free demo software, prices and how to order please contact: 


QBS Software Limited, 10 Barley Mow Passage, London W4 4PH 


Tel: 081-994 4842 Fax: 081-994 3441 


CIRCLE NO. 482 


BBS: 081-747 1979 


ie best FORTRAN 
compiler on any platform, anywhere - and 
believe me, I’ve tried them all.” (available for 386 or 
486, DOS or Unix) 


“We bought INTERACTER as a graphics library 
for PC , Unix and VAX, but now we use it for menus, 
input screens and system access too, INTERACTER 
makes our code user-friendly and portable.” 


“We started with 150,000 lines of vintage FORTRAN... 
SPAG translated it to beautifully structured Fortran 77 
which worked first time. The whole operation took 2 
man days; we estimated 6 man months without SPAG. 
That's what I call productivity” 


YRC) a sdal totem he p/usFORT toolkit (which includes 
SPAG) has been greatly enhanced. New features 
include a global static analyser, standardisation of 
declarations, automatic clutter removal, variable 
renaming and many more. 


Call today for a free demo diskette featuring these (and 
other) products. 


If you use FORTRAN, you 
MUST check this one out. 


ee 
Polyhedron Software Ltd. 

Linden House, 93 High Str. Tel, (44) 0865-300579 
Standlake, Witney OXON Fax. (44) 0865-300232 
OX8 7RH United Kingdom Compuserve 100013,461 


US TOLL-FREE FAX 1-800-777-5519 
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mplete FORTRAN 
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Tim Wool 
FTN77/386 User. 
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oinpilet that | have ever Se! 
environment’. 


NDOWS 3.0 
iced wiPORT! 


“Lind the FTN77/3x, 
We often dows 

development trom infin 
through this compu 


Tam very impressed and have decided to shift all our 
production programs over to FTN77. 

Dr. GR. Chaplain 
NCL Investments Ltd. 


~The debugger was very easy lo use. There 
is an on-line help facility. which made 
reference to the manual unnecessary. 

.. Mike Guan and Arul Britto, 
EXE Magazine, May 1989. 


FROM GREAT WESTERN INSTRUMENTS 


XMEM - Virtual memory manager 
using base, expanded, extended or 
disk, Similar to malloc. Ideal for real 
mode memory hungry applications. 


With source code. £145 ircle 418 
MEMORY TOOLKIT - Library of routines 
to manage expanded (EMS) and 
extended (XMS) memory. Big DOS 
arrays can be created in EMS or XMS. 
With source. £95 Circle 419 
EMPTY SHELL: C routines for freeing up 
memory when shelling to a large 
program. Also saves program screens 
and graphics mode. Uses expanded, 
extended memory or disk to save 
swapped code. £165 Circle 420 


OVER-C+ - Compact non-preemptive 
scheduler with message queues, 
triggers, timers an memory 
management. Supports Borland C++and 
MS C. Examples included for embedded 
and PC applics, £345 Circle 421 


GREAT WESTERN @ 
-Understanding the needs 
of other designers! 


For immediate information about these 

& ter oto in our range, use 

your Fax/Telephone to call Fax-direct 
(0865) 727232, Item 444401 


Great Western Instruments are the specialists in innovative seaign 
tools for the embedded systems developer. Our services include full 
technical and design consultancy support for all our products. 


AMX 86/386/68000/280 - Real time 
executives from KADAK. Fast, reliable, 
compact and ROMable. Preemptive task 
scheduler with optional time slicing. PC 
and embedded applications using C, C++ 
andassembler.From£995 Circle 422 


EMBEDDED DOS - Fully MS-DOS 3.31 
compatible. Optimised for real time with 
multitasking, reentrant. For PC and 
embedded targets. Very low royalties. 
£455 Circle 423 


SELECT CASE -World renowned lowcost, 
PC based CASE tools supporting SSADM,, 
Yourdon / Hatley / Ward Mellor or HOOD. 
Easy to use, Single user £495, 
Project-SELECT for LAN £995 Circle 424 


SMS - Fully featured software 
Management system. Easy to use. 
Version Control, Configuration, Change 
and Modification Request Management. 
Available for MSDOS, 08/2, OS-9, UNIX 
and VMS. From £490 for single user 
MsDOSs. Circle 425 


The above is only a fraction of the full 
range of design tools available. 


Unit_1m Farrington Fields 
Farrington Gurne’ 
Bristol BS18 5U! 

Tel 0761 452116 
Fax 0761 453226 


VAT Extra Carriage Free 
‘All radomarks acknowledged 
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Rob McLaren 
FIN77/386 User 


“For 


FAST, FRIENDLY & FULLY FEATURED - 72 PERFECT MIx-CALL Us Now! 


SALFORD SOFTWARE LTD ¢ VENABLES BUILDINGS @ 5 COCKCROFT ROAD @ SALFORD M5 4NT 
TEL: 061 745 5678 © FAX: 061 745 5666 


“* FTN77 386/486 — extending MS-DOS. 
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“The ease of use, speed, debugging facilities, dynamic 
libraries with resulting small .EXE files, and extensive 
library routines made it a joy to use.” 


sheer 
com » SPeee 
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UNIX version 
AVAILABLE Too! 


“Without the FTN77/386 compiler it 
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Gyre and Gimble 


..are Julian Bucknall’s words for the action of Turbo Pascal’s overlay manager, 
in the first of a new column devoted to !C (= ‘not C’, geddit?) programming. 


There are two alternative beginnings to this 
article: choose the one you believe (a bit 
like The French Lieutenant’s Woman in 
reverse), 


The first was when I was recently compos- 
ing an internal memo on how Turbo Pascal 
V6.0 used memory to overlay my applica- 
tion’s code. I blithely wrote something like 
‘and the code is switched in from EMS in 
chunks of 2 KB to 5 KB...’, when I stopped. 
How did I know how big my overlaid units 
were? With Turbo Pascal's smart linker 
stripping out unused procedures, functions 
and methods the code size reported by TPC 
(the command line compiler) was no help. 
The MAP file gave me information I didn’t 
believe (the overlaid units looked miles too 
small); the manual is silent on the subject. 


The second story was a program crash, My 
error handler from hell gave me the address 
of the failing statement: bang in the middle 
of my overlay buffer. Yeah, well, thanks 
and everything, but which routine in which 
overlaid unit was crashing at that location? 
I mention in passing that the application 
has about 100 overlays, and more Turbo 
Vision spaghetti than Italy. 


So what was I to do? I needed more infor- 
mation on the overlay system. I picked up 
the Turbo Pascal manual, dusted off Turbo 
Debugger, and descended into virtual 8086 
mode. 


Basics 


Overlays are a method of fitting a very large 
program into a restricted area of memory. 
Part of the program is compiled into a sep- 
arate overlay file, and a clever overlay man- 
ager pulls in code blocks from this file into 
a common buffer when they are needed. A 
code block which is no longer being used 
can be discarded in favour of another code 
block. The overlay system in Turbo Pascal 
V6.0 is very easy to implement (a couple of 
switch settings and some code preamble to 
set up the manager), and even has some 
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rudimentary tuning parameters to help it 
run more smoothly. 


I shall be describing the overlay system as 
implemented in Turbo Pascal V5.5 and V6.0 


MULL 
’ ° 
If yow’re feeling 
adventurous, you 
° ° 
could investigate 
how to move the 
overlay buffer 
MUU 
(they are the same); I no longer have V5.0 
and so am unable to check whether the 
ollowing is substantially true or not. I 
would recommend at this point that you 


read the Turbo Pascal manuals on the over- 
lay system (for V5.5 see the Reference Guide 


grammer’s Guide); I shall assume from now 
on that you have a good knowledge of the 
overlay system as described officially by 
Borland. I’m afraid I also assume some ru- 
dimentary assembly language knowledge 
as well. 


In at the shallow end 


First point of attack is all those undo- 
cumented identifiers, di bed oh-so-ter- 
sely in the manuals, These are presented in 
Table 1, together with any extra informa- 
tion I’ve gleaned on the official ones. Be- 
fore looking at it, I must introduce a 
definition. You all know what the segment 
part of an address refers to (the offset in 
paragraphs from the start of memory), Well, 
the overlay manager uses another type of 
segment value, one that is measured from 
the start of the program code itself. Every 
time one of these segment values is used, it 
has to be translated (relocated) to the abso- 
ute segment form. This is easy: just add the 
Program Segment Prefix segment (P re- 
fixSeg) and the size of the PSP in para- 


and the OOP Guide, for V6.0 see the Pro- | graphs ($10). I shall call this unrelocated 
type 
PUnitStubBlock = *TUnitStubBlock; 
TUnitStubBlock = record 
usbint3F : word; 
{ Always $3FCD, the INT 3Fh instruction } 
usbRetOfs : word; 
{ Offset of first return address } 
usbFileOfs : longint; 
{ Offset of unit in overlay file } 
usbCodeSize : word; 
{ Unit’s code size in bytes } 
usbFixupSize : word; 
{ Size of fix-up data block in bytes } 
usbEntries : word; 
{ Number of entries in the jump table } 
usbNextBlock : word; 
{ Locale of next stub block } 
usbBufferSeg : word; 
{ Segment of unit in overlay buffer } 
usbWasCalled : word; 
{ 1 if unit was called on probation } 
usbNextLoad : word; 
{ Locale of next loaded stub block } 
usbFiller : array [1..5] of word; { Unused (?) } 
end; 


Figure 1 - The unit stub block 


System Science 


+ Software + Specialists + Software * Specialist » Software » Specialists * Specialist » Software » Specialists 


Microsoft 
Quick C for Win NEW! £99.00 
Microsoft C 6.0 £220.00 
MS Fortran 5.1 (new ver) £210.00 
MS Windows SDK £210.00 
MS Win SDK & C6.0 £335.00 
MS Basic Compiler 7.1 £225.00 
MS Cobol 4.5 (DOS & OS/2) £460.00 
MS Macro Assembler 6.0 £79.00 
MS Visual Basic £99.00 
MS Quick C 2.5 £60.00 
MS Quick C & Assembler £99.00 
MS Quick Basic £60.00 
MS Source Profiler (new) £49.00 
Authorised Languages Dealer 


Unix 
SCO Unix Op. Sys SCO Unix Dev Sys. 
SCO Open Desktop SCO ODT Dev Sys 
SCO TCP/IP & NFS FTP PC/TCP 
Interactive Unix Op Sy / Architect Series 
Informix 4GL & SQL RM Cobol-85 
LPI Compilers C Scape Screen Lib 
LPI C++ (native) 386 Unix & Sun- NEW 
... many more for 386 Unix and Sun 


C++ Compilers 
see also Borland 
Zortech C++ Dev Ed (incl OS/2) £345.00 
Zortech C++ Sci & Eng £525.00 
JPI TopSpeed C++PExtend £175.00 
JPI TopSpeed C++ SE £115.00 
JPI TopSpeed C++ PE £175.00 
JPI TopSpeed C++ Pro Dev. £229.00 


C Compilers 


see also Microsoft 
Watcom C 8.5 £275.00 
Watcom C386 8.5 with ADS Supp £495.00 
Aztec C 86 (with ROM support) 
TopSpeed C PE 


Mathematics 
Derive - The Mathematical Assistant 
Mathematica 2 Windows (now in ), 386. MAC 
Mathematica for Workstations (Sun, HP..) 
MathCad for Windows (new) — GrafTool 
What's Best! Lindo 
SPSS/PC, Statgraphics Chiwriter Sci WP 


Borland 
Borland C++ & AFW new 3.0 £295.00 
Borland C++ (Dos /Win) 3.0 £195.00 
Turbo C++ Windows NEW! £85.00 
Turbo Pascal Windows £99.00 
Turbo C++ & Turbo Vision NEW! £75.00 


C Datafile 
CodeBase 4.5 for C, C++, Wine new £235.00 
Btrieve - DOS or Windows ver £345.00 


i Turbo Pascal 6 £75.00 
Windows Development Ee eet Ctree Plus from Faircom £345.00 
(see Microsoft and Borland, Zortech) Turbo Pascal 6 Prof £135.00 . : 

CASE:W Corp. £645,00 | | Turbo Debugger and Tools £89.00 | | Faicom Professional Toolbox £745.00 
Smalltalk/V Windows 2295.00 | | Authorised Languages Dealer | |C Communications 
Btrieve for Windows £345.00 Essential Comms £175.00 
Object Trieve Ecall patina ohecker Greenleaf CommLib £195.00 
Commonview £395.00 C Asynch Manager (Blaise £115.00 
Wins+ by Blaise £150.00 Soft-lce/W ( Windows) £259.00 y ger ( ) 


C Screens 

CScape with Look & Feel £365.00 
Vermont Views 3 £335.00 
Panel Plus II £275.00 
Zinc for C++ (Win &Dos) £225.00 
C Graphics 

Essential Graphics & Chart £195.00 
PCX Programmers Toolkit £165.00 


Soft-Ice (for 386 DOS) £259.00 


£95, 
2 CV/1 ( CodeView in a Window) £135.00 


Windows Control Pallette - Blaise 


CrossDevelopment 
2500AD Cross Assemblers £135.00 
2500AD Simulator/Disassemblers £115.00 

Cross Compilers - Introl, Manx, Hitech 


Intersolv (Authorised) 
PVCS for Dos £375.00 
PVCS Config Build (PolyMake) £165.00 
PVCS Networks, OS/2 & Sun £call 

PVCS Professional Editor (SPE) £189.00 
Pascal (see Borland) 


MKS Halo £195.00 
TopSpeed Pascal SE £115.00 | [MKS Toolkit new ver 3.2 £155.00 | | Metawindows £195.00 
Object Professional £110.00 | |MKS RCS new ver 5.1 £155.00 | |... many more libraries 
Btree Filer MU £120.00 | |MKS Lex &Yaccnewver2.6 £155.00 
Asynch Professional £89.00 | |MKS multi-user and OS/2 £call Pharlap 386 DOS Ext SDK £325.00 
Blaise Turbo Vision Toolkit £89.00} |Tools and Editors Pharlap 286 DOS Ext SDK (new) £325.00 
Blaise Turbo Asynch Plus £115.00 | |Brief 3.1 £195.00 

Kedit (Xedit for PC) £99.00 : 

.00 | |.RTPatch for DOS, Win & OS/2 £245.00 Fortran Compilers 
many Basic libraries for comms, graphic -RTLink Plus £295.00 | | Lahey F77L £375.00 
PC Logo £50.00 | |Plink 86 Plus £275.00 | | Lahey F77L-EM/32 with OS386 £875.00 
LMI UR/Forth £295.00 | |Personal Rexx new ver 3 £110.00 | |Watcom F77 386 8.5 with ADS supp £495.00 
Smalltalk V/DOS £69.00 | |Ghost (auto software testing) £135.00 | | Salford FTN 77-386 £765.00 
muLISP 90 225,00 | |EasyCase Plus £345.00 | | PC/Interacter (screens) £325.00 
RM Cobol-85 (new Dev Pack) — £call. C Programmers Toolbox £175.00 | | Ingraf Graphics source £195.00 


.. and many more tools and utilities 


3-5 Cynthia St 
an eae 071 833 1 022 
Fax: 071 837 6411 


« Software « Specialists * Software * Specialist » Software * Specialists * 


System Science 


MS DOS 5.0, QEMM 386 etc _Ecalll. .. many Fortran Libraries 


¢ Prices are exclusive of VAT. 
¢ Prices include delivery to GB. 

¢ Prices are subject to change. 

e VISA, Access and Mastercard 
welcome with telephone orders. 


Sycero 
from System C. 
The best thing on the 


programmer's menu 


System C Ltd 60-61 High St Maidstone Kent ME14 1SR 
Tel 0622 691616 Fax 0622 69124 


CIRCLE NO. 487 


Sycero is a powerful 4GL and applications generator 
for dBASE, Clipper or C programmers. 


Sycero is powerful enough to create even the most 
sophisticated database applications. In fact, it gives 
you the best of both worlds: the speed and ease of use 
of a 4GL with the flexibility of a 3GL. 


Sycero’s complete development environment con- 
sists of a data dictionary, screen and report painters, 
a powerful 4th generation language based on the 
dBASE/Clipper standard. It also includes automated 
program types such as menus and file maintenance, 
reducing the amount of programming needed for 
common tasks. Networking code can be automati- 
cally generated and high quality documentation is 
produced as standard. 


The multi-file report generator lets you build the 
simplest of lists or the most complex invoice, and 
automates sub-totals, pagination, report loops, user 
selection of ranges and sort sequences and wildcard 
matching. 


So, if you want to stay ahead in PC database devel- 
opment and still have time for lunch, call System C 
now on 0622 691616, or return the coupon below. 


= ay i Ry RBS -EXE 2/92 
To: SystemC Ltd 60-61 High St Maidstone 


Kent ME14 1SR 

Please,send me further details about your Clipper 
generator, Sycero dB a 

Please send me further details about your C 
generator, Sycero C | a 

Name ... 
Company 
Address .. 


Postcode .. 


Tel envio FAK ss 


dBASE is a trademark of Ashton-Tate. Clipper is a trademark of Nantucket. 


segment a Jocale, this conjures up a mental 
image of the words local and address so it 
shouldn't be too difficult to remember Cif it 
catches on, you read it here first!). 


As you can see from Table 1, we have some 
intriguing variables (actually typed con- 
stants) to play with later on, First, however, 
a basic question. How does the overlay 
manager know when an overlaid routine 
gets called? Enter the unit stub block and 
the jump table. 


When your program gets linked, each of 
your handcrafted overlaid units gets put 
into the .OVR file, and a ‘stub’ is left in the 
.EXE file itself, one for each unit. This ‘stub’ 
comprises the unit stub block (my term, I 
haven’t a clue what it’s called at Borland) 
and its jump table. The unit stub block is 32 
bytes long and has the layout shown in 
Figure 1. Immediately following this stub 
block isa jump’ table. Each element of this 
table is 5 bytes long, and there is one entry 
for each exported routine from your over- 
laid unit. A call to a routine in an overlaid 
unit will actually call the relevant jump table 
entry. The overlay manager ‘notices’ (exact- 
ly how is explained later!), and if the code 
for the routine is not yet in the overlay 
buffer, the unit is loaded, and the jump 
table adjusted to point to the code. Similar- 
ly, if the unit gets moved in the overlay 
buffer, the jump table gets adjusted again. 
When the unit gets overwritten removed’ 
if you will), the jump table is adjusted once 
more. 


Going deeper 


Slightly more detail now. Each jump entry 
is initially set by the compiler to an INT 3Fh 
instruction (2 bytes) followed by the rou- 
tine’s offset in the unit (2 bytes) followed 
by a zero byte. Suppose an overlaid routine 
gets called and there is nothing in the over- 
lay buffer. As mentioned before, the call 
goes to the start of the jump table entry for 
the routine. The INT 3Fh gets executed and 
lo! the overlay manager gets control (Ov- 
rInit installs it as the INT 3Fh interrupt 
handler), At this point the stack looks like 
Figure 2. 


Excellent! The segment word of the return 
address is none other than the segment of 
the unit stub block, the offset word points 
directly to the routine’s offset in the unit’s 
code block. The overlay manager can now 
work out the location of the unit in the 
overlay file (field usbFileLoc), The 
unit’s code is loaded (together with the 
fixup data block) into the overlay buffer at 
OvrHeapPt r, any fixups are done (and 
the fixup data block discarded), and the 
jump table entries are all altered to 5-byte 


far JMPs (we now know the segment ad- 
dress of the code in the buffer, and the 
offset was in the jump table to begin with). 
OvrHeapPtr is altered to point at the 
next segment in the overlay buffer. By man- 
ipulating the stack, the overlay manager 
ends by transferring control to the newly 
loaded routine. From now on, calls to this 
routine will meet with a far JMP straight to 
the code, and the overlay manager will 
neither know about nor interrupt them. 


Easy-peasy, huh? However, it gets more 
complicated when units are about to get 
discarded from the buffer, Let us ignore 
probation for the moment and assume unit 
Ahas been in the overlay buffer fora while. 
Another unit needs to be loaded and the 
overlay manager notices that unit A will 
have to go (it’s at the tail of the buffer). Now 
some of A’s routines may be active, ie they 
have made calls to other routines and are 
waiting for these routines to return. The 
return addresses are on the stack. If we 
remove the unit, these return addresses will 
be pointing in the middle of some other 
code in the overlay buffer. The overlay 
manager needs to fix the stack so that it gets 
control when these returns are executed. 


bytes (cf 0 


Table 1 - Undocumented Identifiers a 


To do this, it has to assume two things: (1) 
all RETs are far (ie all routines run up to now 
have been compiled with the far model: the 
return addresses will have segment and 
offset components), and (2) all routines 
push BP (the stack frame pointer for their 
caller) as their first action. Turbo Pascal 
does this automatically for you when you 
declare procedures and functions as far; 
beware, however, if you do some assem- 
bler programming. 


The overlay manager can now ‘walk’ 
through the stack until it finds a return 
address segment for the unit about to be 
overwritten. It saves the corresponding re- 
turn offset, and replaces the full return ad- 


Top of stack segment 


Original Caller's return segment 

Original Caller’s return offset 

Flags : 

Return segment from the INT oFh 
_ Return offset from the INT 3Fh 


Figure 2 - The stack the 
overlay manager sees 
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| 
| 
| 


const 
LoadCount : word = 0; 

var 
StubBlock : PUnitStubBlock; 
RoutineOfs : word; 

begin 


{ When called, 


{ in the unit itself. 
asm 
xor AX, AX 
mov StubBlock.Word[0], 
mov StubBlock.Word([2], 
mov RoutineOfs, BX 


AX 
ES 


{ Tracks OvrLoadCount } 


ES is the segment of the unit } 
{ stub block, BX is the offset of the routine} 


procedure OvrTracker; far; end; 
{ OvrTracker gels called whenever the overlay } 
{ manager is about to relinquish control. } { Increment the number of times StubBlock } 
{ Install with the statement: } { has been trapped. } 
{ OvxDebugPtr := @OvrTracker; } { The 5th filler word is used as a counter. } 


{ counter. 


begin 


end; 
} 
{ At this point, you may call another } 
{ UNOVERLAID routine, and pass StubBlock and } 
{ RoutineOfs as parameters if needed. } 


end; 


inc (StubBlock*.usbFiller[5]); 

( I€ OvrLoadCount has changed, the unit used 
{ by StubBlock has just been loaded. 

{ The 4th filler word is used as a load 


if (OvrLoadCount <> LoadCount) then 


LoadCount := 
inc (StubBlock”.usbFiller(4)); 


OvrLoadCount ; 


dress with the unit stub block segment, zero 
offset (ie the INT 3Fh instruction in the stub 
block: ah ha, light dawns!), The saved offset 
is placed in field usbRetOfs. The man- 
ager continues its walk, and all other return 
addresses for the same unit will have only 
their segment word changed, to point at the 
unit stub block (don’t worry, they are never 
executed in this half-and-half state). When 
the program eventually executes a RET toa 
removed routine, the unit stub block will 
get called instead. The INT 3Fh is executed, 
and the overlay manager gets control. It 
notices that it was called due to a RET (the 
last word on the stack will be a 2 - think 
about it), loads the unit, and patiently re- 
fixes all the unit’s return addresses on the 
stack (ie all return addresses that have a 
segment equal to the unit stub block). Fi- 
nally, it pushes the return address that 
should have been used (the segment is the 
unit’s new segment in the buffer, the offset 
was stored at ubsRet Of s) onto the stack, 
and issues a RETF. 


By now you should recognise that the stack 
fixing stuff gets done every single time a 
unit gets loaded, or indeed every single 
time it gets shuffled around the buffer. Ifthe 
unit is in the buffer, its return address seg- 
ments in the stack point into the buffer, if 
not, they pointto the unit stub block. In fact, 
every time the overlay manager gets called, 
it walks the stack and fixes the segments for 
any overlaid unit it finds. Better safe than 
sorry. 


The probation scheme works in roughly the 
same way. When the overlay manager no- 
tices that a unit has entered the probation 
area, its jump table is altered to the INT 3Fh 
version. If the unit gets called on probation, 
the usbWasCal led flag gets set and the 
jump table altered to far JMPs once more. 
When the unit reaches the tail of the buffer, 
the overlay manager notices the flag has 
been set, resets it, moves the unit’s code 


72. EXE Magazine, Vol 6, Issue 8, February 1992 


Figure 3 - The OvrTracker procedure 


from the tail to the head of the buffer and 
gives the unit another ride around. 


Time to Interfere 


The procedure in Figure 3 (OvrTracker) is 
a debug routine whose address you can 
install into OvrDebugPtr. OvrTracker 
uses two unused fields at the end of each 
unit stub block to track probation and load 
calls, As mentioned in Table 1, the debug 
procedure must be far, with no parameters. 
On entry, ES is the segment of the unit stub 
block in question (BX is significant as well, 
it is the offset of the routine to be called). 
We don’t know explicitly (as far as I know) 
whether the procedure was called due to a 
probation trap or a unit load, just that it will 
get called as the last thing the overlay manger 
does before returning to the main program. 


I've declared a single typed constant (mi- 
micking OvrLoadCount) to track the 
load calls. Install OvrTracker immedi- 
ately you've initialised the overlay manager, 
the manager's EMS driver (if used), and have 
finished altering the overlay buffer size. 


The code is small and easily understandable. 
One warning. do not put this procedure in 
an overlaid unit: the program will nose-dive 
at Mach 2. At the end of the procedure is a 
comment showing where you could place 
a call to another procedure, for example to 
dump the overlay buffer map to disk or 
printer. Again, to be pedantic, do not pat 
this called procedure in an overlaid unit, 
and do not allow it to use any overlaid 
routines in its turn. Remember when this 
procedure is called, the overlay manager is 
still active and it definitely is not re-entrant. 


function RealAddr (Locale : word) 
{ PUnitStubBlock from a locale value 
begin 


if (Locale = 0) then 

RealAddr nil 

else RealAddr 
end; 


procedure OvrWalker (FullList 


var 
StubBlock : PUnitStubBlock; 
begin 


if FullList then 
StubBlock := 
else StubBlock := 


( Walk through the chain ... } 
while (StubBlock <> nil) do 
with StubBlock* do 
begin 


if FullList then 
StubBlock 
else StubBlock 
end; 
end; 


: PUnitStubBlock; near; 
{ RealAddr calculates the actual address of a } 


{ A locale of zero = the end of the chain i} 


Ptr(Locale + PrefixSeg + $10, 


: boolean); 

{ OvrWalker walks through the full unit stub } 
{ block list if FullList is true, otherwise it } 
{ walks through the list of loaded stub blocks.} 


{ Get the first stub block in the chain } 


RealAddr (OvrCodeList) 
RealAddr (OvrLoadList) ; 


{ Get next stub block in the chain } 


RealAddr (usbNextBlock) 
RealAddr (usbNextLoad) ; 


) 


OF 


Figure 4 - The OvrWalker procedure 


Ask about our 
NEW Windows 3 
Version 


A poor workman 
will always 
blame his 
tools... 


what if 
the tools are ee 


less than the best? ee 


A craftsman is only as good as his tools and a good craftsman always uses the best tools for the job. ED 
provides a rich, powerful text editing environment with all the features you need for programming in the 90s. 


Ease of use, congfigurability and attention to detail are paramount in ED’s design. You will be up and running 
right out of the box. ED even emulates other editors, Brief, Wordstar, Norton editor and Qedit . 


ED’s capabilities leave all other text editors behind and coming from QBS you get a level of service and 
support nobody else provides. 
If you currently use cumbersome, slow, old fashioned tools, then it’s time for a change. Take control, move 
into the fast lane with ED today, you owe it to yourself... . ONLY £99 


Call for a free DEMONSTRATION DISC 


34 ; : @ Fast C extension language @ Save/restore editor state 
Some of ED Ss High lights for ultimate control. Includes between sessions, including 
i source code for nearly all files and windows. 
@ Edit files to 100MBytes+, with @ Easy to use pull down menus, editor commands. © Clipboard, Text buffers and 
lines up to 1024 characters. context sensitive help, help @ Regular expression search Bookmarks. 
@ Use screen resolutions of bars and quick reference and replace. @ Run any DOS program or 
132 x 60 or more. guides. @ Smart indenting, templates, Shell to DOS. 
@ Multiple windows and files. @ Full LAN and multiuser support. object matching, code @ Flexible printer support and 
@ Cut and Paste text between @ Run compilers with error tracking. completion etc. background printing. 
files and windows with just a @ Releases all memory for your @ Named keyboard macros. ©@ Directory Tree. 
few keystrokes. compiler. @ Flexible, fast, easy to use @ Word wrap and Paragraph 
@ Full support for rectangular @ Language sensitive editing for and fully configurable. reformat. 
Column blocks. C/C++, dBase, Clipper, Data- @ Calculator, Calendar, Line 
@ Unlimited UNDO and REDO. Flex, PFX+, Pascal etc. drawing, ASCII chart etc. Plus much more. 


ftw: imi “Thanks for a great product. It's just what I've been 
QBS So are Li mited, looking for in an editor. | have tried many editors in my 


time, including Wordstar, Brief, Norton Editor, VIPC but 


“ft 10 Barley Mow Passage, none match ED's power and flexibility.” 
§ (elt London W4 4PH David Bagnara, Bell Organisation Pty Ltd, Victoria 
it "| have deleted Brief from my machine." Damian Lewis, 
Tel: 081-994 4842 Kenneth A. Hansen & Associates P/L, Victoria 
‘ Fax: 081-994 3441 ‘Balk - 
the rs editor BBS: 081-747 1979 rilliant editing system. 


Geoffrey Evelyn, Tyne & Wear 
© Soft As It Gets 1991 
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!C 
UNIT OvrUsage; { Assume we/re running under MSDOS 3.0+, and } 
{ the MAP file name is Lhe same as the EXE} 
{$0-} { No overlays allowed here } { file name with a '.MAP’ extension. } 
MapFileName := ParamStr (0); 
INTERFACE MapFileName[0] := char(Pos(’.’, MapFileName) - 1); 
iscoudsevtayy MapFileName := MapFileName + ’.OVR’; 
IMPLEMENTATION UeOpenrebee Maurer 
Assign(F, MapFileName) ; 
eye Reset (F); 
PUnitStubBlock = *TUnitStubBlock; , ; , Rena 
RUTIR CEU RBIGER ae teeta { lies ‘the first three tines (the headings) } 
usbint 3F a wordt for i := to 3 do readin(F, Line); 
Mepaeegrs : aed ; { Read through the MAP file until we get to } 
aa E uae! { the the line for the heap. For each line } 
ie RSERES (8 OE { read, get the start locale and unit name } 
usbFixupSize : word; { and store in the local array NameArray. ) 
usbEntries word; 4 := 0; Finished := false; 
usbNextBlock : word; eepeat : ‘ 
usbBufferSeg : word; readin®y. Line 
usbWasCalled : word; inetile ‘ 
usbNextLoad : word; ; z ‘ 
; th NameA a 
usbF iller array [1..3] of word; e eain eeay (el 0 
usbOurLoads : word; { 4th filler - redefined } Line{1] r= '$'; 
usbOurTraps : word; { 5th filler - redefined } Val (Copy (Line, 1, 5), Locale, ec); 
; , ' 1 ; 
end; Name := Copy(Line, 23, 8); 
{ The saved previous exit procedure ) waa Wame= “HERE “Yi Selieb) Bindenedt de ene? 
var ‘ en 
ExitSave : pointer; Ea ca 


{ Procedure OvrTracker is the essentially the } Pchne ‘i iS 
{ same as that in Figure 2; we don’t want the } { Open the statistics file OVERLAY.DMP, ) 
{ routine offset this time however. } { output the ‘headings... ) 
procedure OvrTracker; far; Assign(P, "OVERLAY. DMP’); 

Rewrite (EF); 


const ; 
Paadosane nqgevaseads writeln (Py ‘Overlay usage for ', ParamStr(0)); 
eh: writeln(F); 
SeuBBlodk 4 PUniwenbeneen) writeln(F, ‘Name---- -Size Traps Loads’); 
begin { Now walk the unit stub block chain } 
asm a StubBlock RealAddr (OvrCodeList) ; 
xor 1 F StubLocale OvrCodeList; 
mov StubBlock.Word(0], AX while (StubBlock <> nil) do 
mov StubBlock.Word(2], ES with StubBlock* do 
end; begin 
inc (StubBlock*®.usbOurTraps) ; { Find the unit name } 


if (OvrLoadCount <> LoadCount) then i um Oe 
begin i , 
Se Gane: ten OUELRAACOUNE} adie (nanelveng is) Locale <> StubLocale) 
inc (StubBlock*.usbOurLoads) ; 
end; { Write details to the Usage file } 
end; writeln(F, NameArray(i] .Name, 
usbCodeSize:7, 
usbOurTraps:7, 


{ RealAddr calculates the actual address of a } 


{ PUnitStubBlock from a locale value ) usbOurLoads:7) + 
function RealAddr(Locale : word) : PUnitStubBlock; near; 
begin { Get next stub block in the chain } 
{ A locale of zero signifies the end of a chain } StubBlock := RealAddr (usbNextBlock) ; 
if (Locale = 0) then StubLocale := usbNextBlock; 
RealAddr := nil end; 
else RealAddr := Ptr(Locale + PrefixSeg + $10, 0); Close (F); 
end; end; 
{ Procedure ReportUsage is designed as an exit } var 
{ procedure. It reads the MAP file to get the } OvrFileName : string; 
{ unit names, and then dumps the unit usage } 
{ statistics to file OVERLAY.DMP. ) begin 
{ WARNING - contains NO error checking. ) { Assume we’/re running under MSDOS 3.0+, and } 
procedure ReportUsage; far; { the overlay file name is the same as the EXE } 
const { file name with a '.OVR’ extension. } 
MaxUnits = 100; { The max no of units we cater for } OvrFileName := ParamStr (0); 
type OvrFileName(0] := char(Pos(’.’, OvrFileName) - 1); 
UnitName = record { To store data for each unit } OvrFileName := OvrFileName + ’.OVR’; 
Locale : word; 
Name : string(8]; { Initialise the overlay manager, with a buffer} 
ends { twice the size of the original. Set the } 
var { probation area. } 
i, ec : integer; Ovrinit (OvrFileName) ; 
StubBlock : PUnitStubBlock; OvrSetBuf (OvrGetBuf * 2); 
StubLocale : word; OvrSetRetry (OvrGetBuf div 3); 
mapetiorine : eng? { Install OvrTracker. } 
Line : string absolute MapFileName; OvrDebugPtr := @OvrTrackers 
NameAneay: fae eay) Maer MaxUnoes) Osh UpvtName? { Install the ReportUsage routine as an exit } 
Finished : boolean; { procedure, ) 
begin : ExitSave := ExitProc; 
ExitProc := ExitSave; ExitProc := @ReportUsage; 
end. 


Figure 5 - An example Overlay Usage unit 
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5 out of 5 hackers prefer other software 
protection methods to Hardlock E-Y-E? 


What hackers dislike... 

Hardlock E-Y-E was designed using cryptographic 
principles. It took the experience and know-how of 
Germany’s No.1 in software protection and the 
leading edge technology of a US semiconductor 
company to create the ultimate software protection 
tool. Hardlock E-Y-E is based on a custom chip 
featuring secure algorithmic response rather than 
simple bit swapping or counting schemes. 


What software developers like... 

Hardlock E-Y-E combines all the features software 
developers require in a single product: algorithmic 
response to provide security and an optional non- 
volatile memory to allow custom configurations. 
FAST Electronic has made implementation of 
Hardlock E-Y-E in your software easy. Use HL-Crypt 
to protect .EXE or .COM files, or incorporate high 
level language interface routines in your software. 
The algorithm parameters and the contents of the 
memory can be programmed in seconds using our 
Crypto-Programmer card. This unique card guaran- 
tees that no one else can burn your original codes. 
Simply plug the card into any PC slot and start up 
your own Hardlock E-Y-E workshop. 


What your customers will like... 

Hardlock E-Y-E allows unlimited backup copies. The 
device is shipped with the software for the user 
simply to plug into the parallel interface and forget. 


Daisy chainability, outstanding reliability (no battery is 
needed), and the most compact High-Tech design 
ensure that your customer will accept Hardlock E-Y-E. 


What your accountant will like... 

Hardlock E-Y-E needs no factory coding. This ensu- 
res optimum delivery schedules and stock flexibility. 
Revenues will 
go up as soft- { — 
ware piracy i 
and multiple 
usage are pre- 
vented. Despite 
its wealth of 
features, 
Hardlock E-Y-E's 
prices remain 


competitive. 

...As more and 

more software Hardlock E-Y-E 
developers programmable, algorithmic response 


customers and and memory option - all in one. 


accountants appreciate the Hardlock E-Y-E device, 
hackers like it less and less. 


MMAGNIF @ 


Order your demo unit today. Contact Magnifeye, 
235-239 Walmer Road, Walmer Studio #6, W11 4EY, Telephone 071 221 8024, Fax 071 792 3449. 
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The procedure in Figure 4 (OvrWalker) 
enables you to walk the unit stub block 
chains: both the full chain and the loaded 
units chain (the overlay buffer map), its 
action dependent on a passed boolean 
parameter. The former mode could be 
used in an exit procedure to dump the 
usage of the overlaid units at the end of the 
program (especially if you've installed 
OvrTracker as well). The latter mode 
could be called by Ovr Tracker itself, to 
dump the overlay buffer map to disk 
every time the overlay manager gets con- 
trol. As an alternative, you could install it 
in your own error handler from hell, to be 
called when a run-time error occurs in the 
overlay buffer. 


The only problem with OvrWalker and 
the unit stub blocks is that you've no real 
idea which unit they're talking about. Enter 
the MAP file. If you compile your pro- 
gram with the TPC compiler and use 
switch /GS, you'll create a MAP file show- 
ing all the segments in your program: code, 
data, stack, and heap. Each line in this MAP 
file shows the start and end segment values 
(locales in my parlance), the size in bytes, 
the name and class of each segment. If you 
walk through the unit stub blocks with 


es can be matched 
the MAP file. The 


OvrWalker, their local 
to the start locales in 
best thing to do would be to simply dump 
the unit stub blocks to a file from within 
your program, and then write an analysis 
program to operate on this file. By reading 
and parsing the MAP file first, the analysis 
program could easily attach meaningful 
unit names to each of the stub blocks. In 
Figure 5, I show the code for a unit (with 
no error checking for brevity’s sake) that 
initialises the overlay manager, installs 
OvrTracker, and, on program termina- 
tion, uses the MAP file to produce a simple 
usage dump of the overlaid units. 


Conclusion 


As I have shown, the Turbo Pascal overlay 
manager is extremely sophisticated, both 
from an external viewpoint and also from 
watching its internal machinations. 


From the undocumented features I have 
laid bare, you can now find out how best to 
use overlaid units, which ones to overlay, 
and conversely, which ones not to. You can 
find out by observing your own program 
whether the recommended probation size 


(one third of the overlay buffer) is the best 


IC 


for you. You can decide whether to split up 
large overlaid units or not. 


f you’re feeling adventurous, you could 
investigate how to move the overlay buffer, 
how to shrink it, and (harder) how to grow 
it dynamically, as your program relaxes and 
intensifies its demands on the heap. Per- 
haps, like me, you could write your own 
unit to load overlaid units from XMS rather 
than EMS, disable the 64 KB EMS page 
frame, and reuse the memory for something 
else (the overlay buffer?). 


EXE! 


Julian Bucknall has been designing and 
programming for 12 years, and full-time in 
Turbo Pascal for the last three. His other 
favourite language used to be RPG III, so 
there’s no hope. Off work, be can be found 
at the wheel of bis red Volvo 18008 in and 
around London, a Saintly vision. 

Turbo Pascal V6.0 Professional is a product 
from Borland International (0734 
321150), and is available from all the dea- 
lers, eg Grey Matter (0364 53499) asks 
£137. 


F inally, there’s a CASE tool that won't 
jet in the way of your creativity... A 
tool that makes structured analysis, 
structured ceeian and data modeling 
as easy as working with any other tool 
on your PC - EasyCASE Plus! Using 
EasyCASE Plus’ new, easy to use 
graphical user interface (GUI), you'll 
be creating and editing charts, linking 
them, and building your data dictionary 
in no time. As well as being easy to 
use and easy to learn, EasyCASE 
Plus is easy on your budget! Ask any 
user. They'll tell you it's the best buy 
for your PC based CASE tool needs. 
Discover why over 4,000 software 
professionals use EasyCASE Plus 
and how you can join them! 


Requirements: 

Runs on: IBM PC or PS/2 (AT recommended), 
DOS 3. or higher, EGA/VGA color, mouse, 640 K 
RAM (500 K free), 1 MB EMS recommended, 
math co-processor supported. Printers/Plotters 
Supported: Epson FX & LQ, IBM Graphics & 
Proprinter X24, HP QuietJet, DeskJet, & 
LaserJet, HP Plotters, PostScript. 


EasyCASE Protessional..... £420* 
(includes integrated DFD level balancing and 
data dictionary/diagram analysis) 
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“EasyCASE Plus is a well designed, low priced = | AN\ GUAGE 
tool that is easy to learn and provides excellent 

diagramming Capabites “asyCASE Plus is 
an excellent investment.” 1 


Methods: Diagram Types: 

™ Yourdon/DeMarco ™ Data Flow Diagrams (DFDs) 
= Gane & Sarson ™ Structure Charts 

= SSADM (DFDs) ® State Transition Diagrams 

"= Ward-Mellor/Hatley ™ Entity Relationship (ERDs) 
= Yourdon/Constantine " Data Model Diagrams 

™ Martin ™ Transformation Schema 
"Chen, Bachman (real-time DFDs) 
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y £320" 


1 The Maltings, Green Drift, Royston, Hertfordshire SG8 5DB 


Features: 

™ IBM SAA/CUA compliant graphical user q 
interface (GUI) 

" Extensive diagram editing features 

" Integrated dBASE III compatible data 
dictionary 

™ Integrated dictionary manager, reports 
manager, process editor 

" Hierarchical chart linking & process 
decomposition 

™ Record and element definitions 

™ Extensive printer, plotter and desktop 
publishing support 

™ Data dictionary import, export, and merge 

™ On-line help 

™ Comprehensive documentation with tutorial 

™ Access to your database, word processor, 
DOS, etc. 

™ Integrated diagram analysis (optional) 


THE 
/Eyergreen SOFTWARE 
(ee ASE CONSTRUCTION 
co. LTD. 


FAX; (0763) 244025 


: Tools 
packages 


Call today for a brochure! 
Tel: (0763) 244114 


Put the physics of programming to 
work for you. @® Right out of the box, 
together or separately, Solution 
Systems products give you leverage 


that will send your productivity soaring. 


It all begins with BRIEF. Our 
programmer's editor is the favorite of 
programmers around the world, 


renowned for its speed, configurability, 


and ease of use. @® dBRIEF for 
X-Base and Paradox are award-winning 
. add-ons that custom tailor BRIEF for 


DBMS development. BRIEFor C++ 
adds a C++ browser to BRIEF for 
those of you with an object 
orientation. @B Sourcerer's 
Apprentice provides version control 
that's seamlessly integrated with 
BRIEF. It's never been easier to keep 
track of development on individual PCs 
and Novell or UNIX-served networks. 
©&® And then there's C-Worthy. The 
User Interface Development System. 
C-Worthy gives you the menus, 
screens, colors, and screen designer 
you need to create great-looking 
applications at warp speed. @® When 
you're ready to wrap it all up, CHARGE, 


an interactive code profiler with direct 


BRIEF 


access to BRIEF, will give you new 
insight into your code’s performance. 
@® Raise your productivity and 
creativity to new heights. Apply the 
physics of programming to your 
applications today. 


@ 
AUTHORISED DEALERS:- = 
Absolute Computing 0923 56043 + Bonsai 071-631 5454 + Computer Solutions Solutionsyster nS 
0932 352744 » Computacentre 0923 56040 + Computerland 0256 816611 + 
Corporate Computers 0245 450039 + Grey Matter 0364 53499 + International 1 The Maltings, Green Drift 
Software 081-479 0049 + Metrocom 081-740 6666 + P&P Corporate 0706 217744 . Bs, . nut 
+ Roundhill 0672 84535 + Software Box 0904 783036 + Software Construction Royston, Hertfordshire SG8 SDB 
Co. 0763 244114 » Software Corporation 0904 691391 + System Science 071- . 
833 1022 + Technomatic 081-205 9558 + Technology Plc 0925 818220 + Telephones) 703%20-18\ 
Worldwide Computers 081-543 2211. Facsimile: 0763 244025 


©1991 Solution Systems 
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XxBASE 


Towards a fully 
object-oriented Clipper 


Nantucket is evolving Clipper away from its dBASE compiler origins 
towards an OOP future, as Chris Sennitt explains. 


Nantucket has been talking about an ob- 
ject-oriented Clipper since 1988. This article 
looks at how far down the road Nantucket 
are with this technology; which problems 
have been tackled by the current (5.01) 
release of Clipper, and those which remain 
to be addressed. 


When considering Clipper’s evolution, it’s 
important to understand the enormity of 
the problem that Nantucket faces: how to 
convert the thousands of Clipper pro- 
grammers to OOP without frightening them 
into the arms of, say, Fox or Borland. Many 
Clipper programmers come from a non- 
technical background, having started out 
using a ‘faster dBASE’. The strategy Nan- 
tucket has adopted appears to be the evol- 
utionary approach, with incremental 
upgrades gently easing the Clipper pro- 
grammer into a new ways of solving com- 
plex business problems.’ 


This strategy has worked well with earlier 
upgrades. User Defined Functions, for 
example, were a simple extension to the 
old procedure mechanism: change the 
word procedure to function, add a return 
expression and you have a function not a 
procedure. Although OOP is slightly more 
complex, the current campaign to upgrade 
the current user base from Summer ’87 ver- 
sion to the ‘OOPier’ 5.01 release appears to 
be working. 


local aFreq[10], aHtz 


// Copies the array pointer aFreq to altz 


aHtz := aFreq 
aFreq{1] := 1066 
? altz(1] / Outputs 1066 


Figure 1 - Assigning Clipper 
array variables 
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Under the surface 


What was in the current release of Clipper 
5.01 reflecting the modernisation of the lan- 
guage? There was a pre-processor and a 
handful of operators borrowed from C, and 
a sophisticated Virtual Memory Manage- 
ment system which allowed programs to 
handle up to 16 MB of variable storage. 


But most notably missing from this release 
was a full implementation of OOP. Instead, 
Nantucket supplied four fixed classes, a 
Table Browser (TBrowse), a Table Col- 
umn (TBColumn), an Error class 
(Error) anda Get class (Get), There was 
no facility to define or create new classes. 
These four fixed classes have had a mixed 
reaction. For the novice they are confusing, 
for the adventurous Clipper programmer 
it’s just enough to whet the appetite, and for 
the full professional it’s not enough. 


Nantucket has recently announced that the 
next release of Clipper 5 will have a full 
implementation of OOP, with an object- 
oriented SQL Interface to follow, Although 
Nantucket was 12 months late with Clipper 
5, | think the steps taken towards OOP so 
far indicate that the full OOP version is not 
too far off. 


What steps has Nantucket made towards 
OOP? For a start there’s the business of 
multi-typed variables. Clipper is a dynami- 
cally-typed language; so you can write 


mixup := 1 
and subsequently code 


mixup := "Surprise!" 


and go on to assign a date to mixup, then 
a logical, then an array etc. While this fea- 
ture is ripe for abuse by inexperienced pro- 
grammers, it does have legitimate uses. 


Clipper Summer 87 was limited in this area; 
arrays could not be passed to and from 
functions, and array elements could not 
contain other arrays. Release 5.01 removed 
these limitations. Arrays are now no differ- 
ent to any other variable, and elements of 
arrays may now hold any data type, includ- 
ing objects and arrays. This has OOP impli- 
cations because, from the point of view of 
the Clipper language, objects and arrays are 
very similar. An object’s instance variable 
can hold any data type, including arrays 
and objects. So we can imagine an object 
containing an instance variable that con- 
tains an array of objects that each contain 
an instance variable that has an array... to 
any depth. 


Then there’s Clipper’s system of garbage 
collection. The Virtual Memory Manage- 
ment system, combined with its dynamic 
typing, allows Clipper to recover unused 
memory automatically. In most typed, dec- 
larative languages the scope and lifetime of 
a variable (and its memory space) can be 
calculated at compile time and code is 
generated to reclaim this memory, In some 
languages, destruct messages may be sent 
that clear down other run-time resources 
suchas file handles. With a non-declarative, 
dynamically typed language, scoping rules 
and the lifetime of some variables can only 
be deduced at run-time, 


To understand the problem, look at the 
implementation of arrays. It’s important to 
distinguish between the space allocated to 
a Clipper variable and the separate piece of 
memory allocated to its data. Internally the 
variable contains a reference to the array 
memory, in much the same way that a C 
char * points to the actual string. The 
pointer stuff is completely hidden from the 
Clipper programmer (thus removing the 
requirement for 90% of the debugging ses- 


‘DESkey’ Software Protection 


system from Data Encryption 
Systems Limited 


We have more experience and 
expertise in the design of software 
protection modules (dongles) than 
any other company in the UK. We 

sell only products designed in 
house by our own engineers — 

the same engineers that give 
you technical support. More 
than |3 years experience in the 
design of dongles have gone into 
our current product range with 
‘features such as: 


* Pseudo Random Number Generator Billions and 
billions of random numbers without repeating. 
Software and Data encryption could not be easier. 
‘Seedable' too! 

+ Through Encryption. Data may be fed into the 
DESkey for on-line encryption, This keeps the 
encryption key hidden. 

* Memory. Up to 240 bytes of memory split into 
‘Public’ and ‘Private’ sectors. The ‘Public’ sectormay 
be read from and written to at will, The ‘Private’ 
sector may be read at will, but forwriting, it requires 
your customer specific password. 

* Down Counter. You program into the DESkey 


SOFTWARE 
MANAGEMENT 
SYSTEM 


Intasoft m4 


the 
number 
of times the program 

should run before stopping. This gives you the 
ability to sell 'goes’ of your software ratherthan an 
open licence to use it forever—oreven to senda 
fully working demonstration copy that will stop 
working after say, |0 goes. 

+ Variable Response Algorithm. This feature is 
similar to the well known ‘public-key’ algorithm and 
works in conjunction with an algorithm on the host 
computer, Makes any attempt at software 
emulation impossible. 

* Secure Memory Read. Even ifthe same memory 
data is read repeatedly, the dataretumed fromthe | 
DESkey never appears the same —this also makes 
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WHO? WHAT? WHEN? WHY? 


SMS : the fully integrated, automated control system for software changes. 
Takes the guesswork out of revision history and configuration management. 


® Version Control 


¢ Revision Identification and reporting 


° Release and Configuration identification 
° Modification Requests 


Multi-platform: MS-DOS, Unix, VMS, OS/2, OS-9 


PC Prices : 1 User £490, 5 User £980 
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A full set of software management tools accessible via a 
menu-driven front-end with context sensitive on-line help 


the DESkey impossible to emulate. 
* DESlock® automatic EXE or .COM file 
encryption system. No need for source or,OB) files. 
Takes only 5 seconds or less to protect your 
software. 
* Transparent and Cascadable/Stackable. Does not 
interfere with any other device wanting to use the 
same port—even allows other manufacturers 
dongles to work! 
* Parallel, Serial or Bus versions available. 
* Intelligent Serial devices suitable for any operating 
system such as Unix, Xenix, OS/2, DOS ete. Works 
onany hardware including PC Networks, Mini 
Systems or even Mainframes. 
* No programming units required and NO 
hidden extras. 
* Free lifetime telephone support direct with 
the designers. 
* Free evaluation Kits. 
* Guaranteed Exclusivity to all our customers. 
* Fast Order Tum-round, 
* Sold only through Data Encryption Systems 
Limited. 


Data Encryption 
Systems Limited 


Edbrook House, Cannington, 
Bridgwater, Somerset. TAS 2QE 
Telephone (0278) 653456 
Fax (0278) 653300 


¢ Manages multiple revisions, development lines, users ¢ Text and Binary file support 


* Minimisation of storage 


® Configuration Management 
¢ Manages configuration items of a product/project * Automated system building 


¢ Automated dependency generation 


¢ Formalise bug reporting and upgrade procedures *» Change management 
* Definable life-cycle with active notification system * Modification analysis and reporting 


9 (0392) 217670 


for professional software developers NIASOFT 


Tresco House, 153 Sweetbrier Lane, Exeter, EX1 3DG, England Tel: 0392 217670 Fax: 0392 437877 


OOK £0/ 


sions performed by his C-bound brother!), 
although it becomes obvious from the way 
arrays are used (See Figure 1). We now 
have two variables referring to the same 
array, the rule in Clipper is that an array 
does not get garbage-collected as long as 
something live points to it. Clipper’s VM 
system is very sophisticated; it does not use 
reference counting to decide if something 
can be reached as this is too easily fooled 
(see Figure 2). Clipper incrementally scans 
memory variables tagging blocks of mem- 
ory that can be reached. Memory that is not 
tagged is released for future use. 


In C++ an object may be compared to a C 
structure plus methods associated with that 
structure. Internally, 5.01 objects are arrays 
with associated methods. So the VM usage 
for objects is identical to arrays: they live as 
long as they can be reached, 


There’s also the send operator. Implemen- 
tation of the Clipper language is split into 
two parts, the compiler and the run-time 
system. The 5.01 Compiler now under- 
stands the send operator ‘:’ (eg ob- 
ject:message), This generates very 
simplistic code that ‘sends’ the object to a 
run-time system function, along with the 
message and any parameters. The run-time 
system looks up the method associated 
with the message for that class and passes 
control to this method along with the par- 
ameters. So both the compiler and the run- 
time system have some understanding of 
OOP. All that is missing from the standard 
Clipper is the ability to define your own 
classes, 


So the internals of 5.01 are already object- 
oriented; this is how the supplied four fixed 
classes can operate, Third party products, 
like my own company’s SuperClass, use 
these internals to implement a full object- 
oriented extension to 5.01 and have been 
available since May 1991. SuperClass allows 
the application programmer to define new 
classes via some User Defined Commands. 
These commands load the internals of Clip- 
per with the definition of the classes, num- 
ber of instance variables and the associated 
messages and methods. The fixed classes 
supplied with 5.01 load the internals in the 
same way, so the add-ons are just exploit- 
ing the built-in support for objects. 


A Good Question 


‘If all this is already in place, why hasn't 
Nantucket implemented full OOP?, you cry. 
I believe Nantucket could have implemented 
an OOP extension between the releases of 
5.0 and 5.01 (a six month period). Here at 
ChyDale Software, it took us a matter of 
weeks to get SuperClass into alpha-testing, 
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Clipper 


// The fooling of the reference counter 


do while .t. 
foolit () 
enddo 


// loop forever 


function foolit () 
local a[10], b[10} 


all) i= b 
b(1) :=a 


return( nil ) 


// be reached. 


// Clipper 


// both arrays have a reference count of 1 


// increase reference count of b by 1 
/ increase reference count of a by 1 


// return will remove variable a and b thus reducing the 
// xveference count of the array referred to by a and b by 1 
// Final count would be 1 so they stay in memory but cannot 


does not use this Primitive mechanism 


Figure 2 - Problems with reference counters 


and that’s without access to the run-time 
source code, 


I believe that Nantucket is delaying for two 
reasons: as a continuation of its gently, gently 
approach to introducing New ‘Things; and to 
enable it to keep Clipper in step with its 
future technology (ie the Aspen ‘Clipper- 
for-Windows’ project). By moving forward 
at ‘just the right speed’, it hopes to take a 
significant number of Clipper programmers 
into OOP. By developing the next DOS 
version of Clipper, code-named ‘5.x’, in 
tandem with Aspen, Nantucket hopes to 
create a class definition syntax which is 
sufficiently robust to be used in both sys- 
tems. This will help in the transition from 
Clipper 5.X to Aspen, 


Possible Features 


Now we have looked at the steps taken 
towards a full OOP Clipper, it is reasonably 
simple to deduce many of its features. The 
syntax is unlikely to be far from that of 
SuperClass and the other add-ons availab 
There are only so many ways to describe 
the names of the instance variables and the 
names of the methods, and in the past, 
antucket has not been afraid to borrow 
ideas from other languages. 


if 


That said, I expect other features to be 
added. For example, many SuperClass users 
have asked for mechanisms to control the 
assigning and accessing of instance vari- 
ables. Suppose we have an object Ob 5 with 
a piece of instance data Dat. Then the 
action 


Obj:dat := 4 


would cause a special piece of code, defined 
by the application programmer, to be called. 
C++ programmers will recognise this as anal- 
ogous to overloading the = operator. Access 
to variables could be similarly regulated 
(there is no direct analogy for this in C++). 


Most of the current add-ons allow the pro- 
grammer to create private, public and read- 


only instance variables. I feel that this is not 
the Nantucket way. Access and assign rou- 
tines could easily replace the need for these 
mechanisms, or alternatively the Super- 
Class mechanisms could easily be simu- 
lated with access and assign mechanisms. 


Let’s look at the possible syntax for defining 
an object. In this late-binding, dynamically- 
typed language, not much is required to 
define an object: a list of its instance vari- 
ables and the code for the methods. Figure 
3 shows a typical definition for a SuperClass 
object. Some lines may not be required by 
a fully OOPed Clipper that understands 
class definitions completely. These lines 
are indicated by comments. Figure 4 shows 
the syntax for single inheritance and the 
overriding of an inherited method (init), 
Although SuperClass supports multiple in- 
heritance, Nantucket has made it clear that 
this feature will not be in the next release 
of Clipper. 


Many of the internal features of 5.01 suggest 
that a lot of the implementation ideas have 
been derived directly from the Smalltalk 
language, most notably code blocks, arrays 
and objects. However, I doubt that Clipper 
will support for class objects. These are 
used in Smalltalk (and other late binding 
languages) to hold information about the 
class, with each class defined by exactly 
one class object. In Clipper, it’s possible to 
hold equivalent information about classes 
by using class variables, which can easily 
be implemented using static variables in the 
class definition file. 


Destruct 


One of the problems that remains for Nan- 
tucket to solve is that of the destructor 
mechanism found in C++, Because C++ is 
declarative and uses early binding, it’s 
possible to predict when an object ‘goes out 
of scope’, and it can then be arranged for a 
destruct mechanism to be called. In Clip- 
per, the problem is much harder. An object 
‘dies’ only when it can no longer be reached 
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"The Best low cost 
alternative personal 
computer" 

P.C. World 


Atomstyle 386 SX 
came top in group 
review. 

P.C. Plus June ’91 
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486/33, “You can't 
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programmer with a 
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speed 156MHz. Expansion 
slots 6x16 bit, 2x8 bit. 
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by the VM system. We then hit a Catch 22 Preparing for the Future 
problem: how do you send a destructor 


message to something you can’t reach? If } Ifall this OOP is being introduced with half 
you can send it a message it must be reach- | an eye on Aspen, what is Aspen all about? 
able, and if it’s reachable then you should | Mainly speed and Microsoft Windows. 
not send it the destructor message. What is | Aspen will include some very sophisticated 
wanted is the ability to call the destructoras | run-time/compile technology that should 
soon as the object is no longer reachable, | enable a ten-fold increase in performance 
and in reverse order of creation. It is not | over Clipper 5.X. It will probably include 


obvious how this can be achieved. optional type declarations that will give 


Clipper 


‘hints’ to the compiler and run-time system 
for method look-up and instance variable 
access/assign. This should then give the 
best of both worlds, a late binding language 
that can be optionally early bound. 


Many Clipper programmers are trying to 
write systems today that will easily transfer 
to both Clipper 5.X and Aspen, It is certainly 
Nantucket’s goal to convert as many of 


/ remove this line Message display () 


#include "SuperC1s.ct 
include "Inkey.ch" 

i cla 
local nkey, olmage 


n()iInit( 4, 4, 22, 47 ) 
K_ESC // The 


key()) $= 


K_DOWN 
wn() 


// Note :: isa 
// implemented with a 


short hand notation for self: 


f#define :: self: 


Figure 3 - Defining a Clipper object 


WINDOWS 
See 


EXE 


At The Windows Tools 
Olympia 18th - 20th 
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Which applications generator is the professional’s choice? 
* Generates error free C source code that compiles first time and every time 
* No run times or royalties — you control the return on your efforts 


* Supports most major databases - protecting your existing investment 


Btrieve 
Oracle 
Paradox 
C-TREE 


DOS - Single/ 
multi user 
PRO-TREE 
UNIX 

QNX 


AIX 


PRO-C is a trademark of PRO-C Canada 
Contact now for Technical Information Pack: 
Tel: (0206) 322822 Fax: (0206) 322890 
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dBase III 
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Free 
Demonstration 
Disk 

available 


or write to: ITEL, FREEPOST, PO Box 2, Dedham, 
Colchester CO7 1BR 
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these programmers as possible. So what do 
you have to do today to achieve this? 


You should certainly avoid older style Sum- 
mer ’87 functions and commands. These 
are clearly marked in the manual and in the 
on-line guides. Declare all variables before 
they are used (LOCAL or STATIC) - this 
is a declaration of the variable’s name, not 
its type. Avoid PRIVATE and PUBLIC 
variables, the scoping and lifetime rules 
make them very difficult to compile and 
optimise. Start to convert the systems over 


to OOP as soon as possible. Always com- 
pile with a /W warning flag, as this will 
notify you of any variables that are used 
without being declared. 


End thoughts 


So what have Nantucket got that’s new to 
the industry? Very little, actually. Most of the 
features have been derived from other lan- 
guages (code blocks, pre-processor, new 
operators, late binding, dynamic typing, 
non-declarative, virtual memory manage- 


#include "SuperCls.ch" 


Class CargoScreen inherit from saveScreen 
var Cargo 


// Remove from here 
Message Init( t, r, b, 1, data 
end class 
// top here 
Method init( t, 1, b, x, data 
:Super():init(t, 1, by x) 
// super:init( t, 1, b, r) is a pos 


Self:Cargo := data 


return( self ) 


// Call the 


// remove this line 


// remove the "From" 


superclass init () 


sible future syntax for 5.x 


Figure 4 - Single inheritance in Clipper 


Clipper 


ment). What is new is that all this is built 
around the Clipper language, something 
that’s easily picked up by millions of exist- 
ing dBASE programmers. 


Is Nantucket’s incremental upgrade strate- 
gy working? Most of the Clipper users I 
meet fall into one of two camps. One camp 
is using 5.01 for the automatic VMM system 
alone - ignoring all the additional features 
of the language I have been discussing. The 
other group is moving heavily into the new 
features; pushing the pre-processor to the 
limits, using 2 MB to 4 MB of VM space for 
variables, using object-oriented add-ons, 
abusing code blocks and making full use of 
the new array features. Admittedly the 
number in camp two is relatively small, but 
it is growing in both size and momentum, 
So the softly, softly approach does seem to 
be working. 
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Chris Sennitt is a Director of ChyDale Soft- 
ware, suppliers of SuperClass and other 
Clipper add-ons, Contact ChyDale on 0977 
683 296. 
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ized C Golde 
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2 


@ Production of opel 


@ Platform independence 
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For further information contact: 


Applied Logic Developments 
9 Princeton Court 

55 Felsham Road 

London SW15 1AZ 

Tel: 081 780 1088 

Fax: 081 780 1941 


FOR MS-DOS 


We are pleased to announce, the release of Eiffel/S, the 


f the Eiffel language, is 
Beftonal Eiffel Consortium. 


¥% PC/non-PC. 


(some units) 


OS/2, UNIX. 


Applied Logic 
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unauthorised use and piracy. 
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and troublefree solutions around. All units are 
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UNIX 


Configuring programs 


Configuration files can make programs more flexible and easier to maintain. 
Peter Collinson has a neat way of reading them. 


There’s always a temptation to burn too 
much knowledge into programs. By this I 
mean that many programs on UNIX have 
some information about their environment 
planted immovably into the binary. For 
example, programs that do clever things 
with terminals will need to access the ter- 
minfoortermcap databases; programs 
that validate users will know about the lo- 
cation of the password file; the wrapper for 
the C compiler ce will know where the 
binaries of its various passes can found on 
the system. The list goes on. 


It has always been the practice to plant 
some sensible defaults into the binary and 
then supply the ability to change them by 
using program arguments. This is OK for 
programs that are run seldom, or for the 
occasion where the change in the defaults 
is temporary. It’s painful to be forced to 
supply parameters every time a program is 
called. It’s easy to do using aliases in the 
shell or front-end scripts, but it should be 
possible to provide better mechanisms. 


Using the environment 


One way of providing a program with in- 
formation is to use the environment. This is 
a set of strings that are passed into pro- 
cesses on the exec system call. By con- 
vention the strings have the form: 


keyword=value 

like 

SHELL=/bin/sh 

Users generally set their environment from 
their shell. 

It’s easy to access the environment from a 
program, a standard routine is used: 
shell = getenv ("SHELL") ; 

will return the right-hand side string if it 
exists, otherwise it will return NULL. 


Setting the environment from programs 
used to be tricky, but many systems are 
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adopting the put env routine making set- 
ting things up somewhat easier. To change 
the SHELL variable, you would say: 


rv = putenv("SHELL=/bin/csh") ; 


The return value is a success/failure indicator. 


The new environment variable is passed 
into any processes that are created by the 
program that called putenv. It’s a com- 
mon mistake to think that the strings are 
stored somewhere central. They are passed 
from parent to child. Consequently, the par- 
ent can affect the setting of a child’s envi- 
ronment but the converse is never true. 


However, we do sometimes want to allow 
a child of a shell to set a variable and a 
commonly asked question is how this may 
be done. It needs a slightly cunning trick. 
The programmer arranges to outputa string 
looking like a shell command: 


VAR=value; export VAR 


for Bourne shell and 
setenv VAR value 


for csh. These strings are printed on stand- 
ard output. Let’s assume that the program 
that generates th’ ‘alled prog. We want 
to execute these setup commands in the 
current shell to load the variable. This 
makes any new command started from the 
shell contain VAR in its environment. 


Both flavours of shell contain a command 
eval. The command executes its argu- 
ments in the current shell. For Bourne shell, 
we can say: 


$ eval "NEWVAL=newvalue" 
this executes the command 
NEWVAL=newvalue 


in the current shell. Of course, this is more 
useful when the argument is a shell vari- 
able. 


For our purposes, we must translate the 
standard output from prog into parame- 


ters for eval. This is easy, we use the 
back-quote operator, Putting this all 
together: 


$ eval ‘prog’ 


This runs prog and picks up its standard 
output making arguments for eval. The 
eval command executes the arguments, 
which will set the environment in the cur- 
rent shell. We are in business. 


Using the environment to provide program 
configuration information is fine. I am 
happy for it to contain things that are used 
regularly, like my search path or the 
termcap information supporting my edi- 
tor and other visual programs. As I write, 
my current environment is 1471 bytes and 
contains 29 variables. Every new process 
that I start has to build a data structure 
containing the characters and establish a 
vector of pointers. 


Being of the old school, I resent the CPU 
wastage. My ears are deaf to the arguments 
that say CPUs are faster and we have cycles 
to burn. Too many people say this, and the 
cycles are being nibbled in all directions. I 
want to minimise my environment. If your 
program isn’t essential to my work, I don’t 
want its variables cluttering up my world. 
They take up precious name space and 
slow me down. 


Lists 


The data that you want to get into the 
application may be unsuitable for loading 
as either arguments or environment vari- 
ables. In this situation, the approach usually 
used on UNIX is to read data from a con- 
figuration file. The file will most often con- 
tain text and is maintained using the normal 
set of UNIX tools, created with an editor, 
searched with grep, sorted with sort 
and so on. 


The simplest type of configuration informa- 
tion is a list of some kind. For instance, you 
want to send mail to a number of different 
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It Takes More Than The Language. 


Unleashing the full potential of C + + takes powerful object- 
oriented tools and a rich library of classes. Using only a 

C + + compiler and traditional tools yields traditional 
results — slipped schedules and maintenance nightmares. 
Only Objectworks\C + +, Release 2.4, provides the 
comprehensive development environment that allows you to 
produce extraordinary results. 


Speed Your Development and Maintenance. 


Objectworks\C + + provides dynamic, graphical browsers 
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C + + source level debugger and interactive browsers ensure 
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and, ultimately, speed your development and maintenance. 


An Open Environment. 
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you fo use your favourite C preprocessor, C compiler, linker, 
profiler, or source code control system. The sophisticated 
Class libraries included in Objectkit\C + + exploit the natural 
synergy between the development environment and the 
extensive reusable class libraries. Objectworks\C + + also 
allows programmers to use existing makefiles without any 
modification, saving time and money. 


Team Programming. 


Objectworks\C + + is the only C + + development 
environment that allows engineers to work cooperatively, 
loading and browsing one another's code, without 
interrupting each other. Programmers simply access an 
information file containing a description of the code they 
need, and then they query this description. 


A\| International are uniquely qualified to help you exploit 
the benefits of object-oriented technology and C + + 
programming applicable to your development efforts. If you'd 
like our technical management brief “Exploiting the Full 
Benefits of C + + Objects”, or are ready to unleash the true 
power of C + +, call us today at 0442 876448 


Without Objectworks, you’re 


without objects. 
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A PC that appears to have a 
virus. A hard disk that claims to 
have lost all its files. A backup 
that won’t restore. A corrupted 
file that locks every user out of 
the LAN. A salesman who 
leaves the company, taking a 
copy of all your customer lists 
and personnel database with him. 


If you keep confidential or 
business-critical data on PCs, 
any of these disasters could 
happen to you. : 


If you don’t protect your 
company’s crucial information, 
it’s all too easy to lose it. 


"Data Protection and Security for 
Personal Computers" is a unique 
guide for managers and senior 
support staff. It tells you everything 
you need to know about how to 
safeguard the information held on 
all your company’s PCs, including: 


e How to avoid viruses. 

e How to ensure that backups 

are taken regularly. 

Preventing unauthorised use 

of company PCs. 

e Buying insurance against PC 
data loss. 

e How to detect and prevent 
theft of corporate data. 

Windows 3.0 security risks. 


TTK 
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"Data Protection and Security for 
Personal Computers" is written 
by Robert Schifreen, one of the 
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security experts. It costs £145, 
and there’s a 14-day money-back 
guarantee. Return the coupon 
below or telephone us now, and 
we'll send you a free brochure 
and a detailed summary. 


Meanwhile, the next time your 
hard disk pretends to be empty, 
or you can’t find your backup 
disks, it’ ll just be someone 
having a practical joke. 


If you’re lucky. 
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people when your program has completed. 
Conventionally, a list like this is entered 
with one entry per text line. The program 
will open the file and input the data a line 
ata time for storage in a structure, or direct- 
ly executing a mail command. 


The code should worry about ignoring 
white space at the start of the line and also 
trailing white space. Some editors will add 
extraneous spaces at the end of lines, and 
the person doing the editing will not be 
aware that it is there. People expect to be 
able to insert dead space so that their con- 
trol files look nicer. 


Also, it’s a good idea to provide a comment 
mechanism in the data file. I generally use 
hash (‘#’) at the start of the line to mean that 
all the text up to and including the next 
newline should be ignored. When you are 
writing the routines to process this type of 
data file, you will often read data a line at 
time using fgets (). As a result, com- 
ments are free - you just look at the first 
character and loop to get the next line. 
Incidentally, you can easily ignore blank 
lines by using the same mechanism. 


The ability to have empty lines and com- 
ments in a control file adds a lot to its 
maintainability. Comments will allow the 
user to describe the values in the file. Also, 
they can contain version information mak- 
ing the file manageable by a source code 
control system like SCCS or RCS. A valuable 
feature is the ability to insert a ‘#’ at the start 
of line to temporarily remove values with- 
out losing the data. Comments are just a 
good thing. 


Simple configuration files 


It’s often the case that configuration infor- 
mation is relational. Rather than just having, 
a simple list, we will want to have a number 
of keywords, each taking some value. It’s 
possible that we want to associate more 
than one value with each keyword. 


For example, there is a file used for storing 
credit in the UKnet accounting suite that I 
was involved with recently. If a site incurs 
a bill of less than £10, then an invoice of that 
sum is sent and the resulting credit stored. 
Next quarter, the credit is applied to the 
next bill. 


The file that drives this contains lines of 
data, with one line for each creditor site. 
The line holds the name of the site, the date 
that the last charge was made and the 
amount of money that the site is owed. I use 
colons to separate the different fields in the 
data file, but any separator will do. 


The credit file is generated automatically as 
a side effect of running the bill generation 
program, but it is still text. It can be exam- 
ined using an editor. It can be updated 
easily too. If the site is invoiced outside the 
normal system, a human may want to come 
along and edit the file to reflect this. 


It may seem that reading and processing 
one of these files is difficult. It isn’t. Let’s 
assume that we are writing an interface to 
the mail system, It’s nice to have a private 
file of aliases so the user can say: 


mail peter 


and have peter expanded to the real 
address of the person. We will have a con- 
figuration file containing several lines like; 


peter:pc@hillside.co.uk 


UNIX 


Each entry in the alias file contains two 
colon separated fields. The first field is the 
name that you want to find and the second 
is the string that is returned for that key. 


When implementing this, the initial thought 
is touse fgets to read each line and then 
examine the first part of the line with 
strcmp to find a matching key. This ap- 
proach works but is slow, involving enor- 
mous amounts of copying. You can use a 
finite state machine to good effect here. The 
routine is to be found in Figure 1. 


The idea is to loop while reading charac- 
ters. Different tests will be done on each 
character that is read depending on the 
value of the variable state. We know 
where we are in the file, and what we 
expect to see next. We use our knowledge 


#include <stdio.h> 
char * 


{ 
enum {( 
NAME, 
} state; 


char *pt; 
char c; 
state = NAME; 
pt = line; 
while ((c = 
switch (state) 


case NAME: 


state = 
else 


*pt = 
pt = 
state = 

} 


else 


} 


case SKIPEOL: 


} 
} 
return NULL; 


/* Using a finite state machine */ 
/* to parse the alias file */ 


readalias (FILE *fi, char *key) 


ADDR, SKIPEOL 


static char line[BUFSI2Z]; 


getc (fi) ) 


if (c == /#") 
SKIPEOL; 


LE (Giem 03'0) 
"NO"; 
if (stremp (line, 
line; 

ADDR; 


state = SKIPEOL; 


else 
*ptt+ = c; 
break; 
case ADDR: 
/* success ? 
df (c == /\n’ 
Apt = NOM 
return line; 
) 
else 
*ptt+ = c; 
break; 


Le” (ome ON of 
pt = line; 
state = NAME; 

) 

break; 


!= EOF) { 
{ 


{ 


key) == 0) [ 


wih 
2) at 


Figure 1 - Code for finite state machine 
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of the syntax of the file to minimise the 
processing that is done. 


The first state, NAME, is used when we 
are processing the left-hand side of each 
line. This is the initial state too, The idea 
here is to store the incoming characters 
until we find the colon that marks the end 
of the first field. When we get a colon, we 
can compare the data we have captured 
with the key. If the key matches, then we 
will need to store the right-hand side be- 
cause that is the data that we need. We 
enter the ADDR state to do this. If the key 
does not match, then we can ignore the 
remainder of the line entering SKIPEOL 
state. If we find a hash character, then the 
line is a comment and should also be 
ignored. 


The second state, ADDR, is only entered 
when we have matched the left-hand side. 
We store the characters that we need until 
a newline is found. Then we exit bearing a 
pointer to the line. 


The final state, SKIPEOL simply discards 
the character until a newline is found, when 
it resets the state machine back to the be- 
ginning. 


The code is actually very rudimentary and 
if you are planning to use it in anger, you 
need to worry about syntactically incorrect 
input. Getting a newline when in the NAME 
state is currently bad news, The state ma- 
chine is possibly a little simple and it might 
be a good idea to deal with leading and 
trailing white space. You tend to do this by 
adding more states. 


You can also improve on the raw use of 
strcmp. When dealing with strings I near- 
ly always compare initial characters before 
executing the costly string comparison. It 
depends on the data involved, but it can 
save an enormous amount of processing. 


However, apart from this, if you look again 
atthe code you should see that it is very fast. 
The code path for processing each charac- 
ter is minimal, perhaps three or four tests 
and a store. Remember also that get is 
an inline macro and most of the time is 
simply picking up a character from a buffer. 


Sometimes finite state machines like this 
can get too complicated, such that it is 
difficult to see what is happening. I like 
them for simple applications like this one. 
They mean that the code works quickly and 


UNIX 


it is easy to see what will happen in any 
particular circumstance. 


Configuring program suites 


When you build a number of programs that 
work together it’s often the case that they 
all need access to the same files containing 
various types of information. Rather than 
burning all the file names into each binary 
you might think about controlling the pro- 
grams by the use of a single configuration 
file. 


There are many benefits. All the programs 
only need to know about the location of a 
single file and derive all other information 
from that, It makes it easy to establish par- 
lel environments for testing, and means 
that you only edit one file if you move the 
location of a file referenced by the suite. 


2 


The configuration file also becomes a 
handy place to store values that might 
otherwise be constants in the programs. If 
the working life of a suite is five or so years, 
then it’s often the case that constants will 
change. For example, the ‘constant’ VAT 
rate recently changed from an integral 15% 
to a floating point 17.5%. 


NEW! 


‘On Demand Reader Information Service 


EXE 


Facts-Direct 


Where advertisers have registered their products and services with Facts-Direct, 
further items of information will be available for readers to retrieve, at their 
convenience, via their fax machine. 


Try it Now! 


Pick up your fax phone, make sure it is capable of generating MF tones (it should 
beep when you press the keys!) call Facts-Direct and follow the simple 


instructions. 


Ring 0865 727 232 for item 300300 


For further information contact: 


Facts-Direct 
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Lance Dorman 


CIRCLE NO. 502 


086 736 696 


We provide a 
One-Stop Solution 


for all your 


* Memory — SIMM, SIP, DRAM, 
Kingston — IBM, Compag PC, 


Sun, Dec, Apollo and others 
%* Disk Drives and Tape Backup 


+ Network cards and software 

* Coprocessors 

* Video — VGA, TIGA etc 

%* Printer — HP, Epson, OKI, 
all the big names 


NEW 


CEG VGA Boards 
Available Now 


Bits’n’Pieces for all your computer 
requirements 


Bits’n’Pieces 
Cowdrey, Northmoor, Witney, 
Oxfordshire 0X8 1SX 


CIRCLE NO, 512 


0865 300683 


Fax: 
0865 300117 


Well for 30 days, at least. See why Prolog-2 
for Windows 3 is already well-established as 
the standard for Windows 3 Prolog 
programming. Call or write now for full 
details of this remarkable evaluation offer. 


Expert Systems Ltd. 


The Magdalen Centre, Oxford Science Park, Oxford OX4 4GA 
Tel: 0865 784474 
Fax: 0865 784475 


CIRCLE NO. 511 


If you’ve tried this, you’ll know what it’s like using 
8051 assembler. 


Admittedly, given enough time and effort, even the 
impossible can be accomplished 


But can your project afford to wait? 


By opting for Keil C51, you will get better results faster 
and without pain. 


C51 is very simple to use and yet yields the fastest and 
smallest code of any 8051 C compiler. With direct access 
to the 8051 cpu at a bit/register level in C, assembler 
programmers feel instantly at home. 


C51 Professional Edition Comprises: 


* Full ANSI C implementation for the,8051 family 
* Near-assembler code efficiency 

* Function-level optimisation 

* Extensions for 80C517/87C751 

* Small/Compact/Large/Banked memory support 
* DScope51+ cpu simulator/debugger 

* ASI macro assembler 

* 8051 Real Time Executive 

* Support from official C51 User Group 


To see how C51 takes the pain out of 8051 programming, 
call now for our comprehensive information pack. 


Hitex (UK) Ltd. 
Warwick University 
Science Park 
Coventry, CV4 7EZ. 


DIKE ELE El oni 


Tel 0203 692066, FAX 0203 692131 
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1 generally create configuration files using 
the familiar 


keyword: value 


syntax, and will allow hash comments and 
blank lines. Different programs in the suite 
will need different information from the 
configuration file. The idea is that each 
program will search for a keyword, or a 
number of keywords, and ignore anything 
that isn’t relevant to it. The value can be a 
number ora string - it’s just some characters 
that the program must read and interpret. 


The value is deemed to end when the new- 
line is reached. The next line will contain 
another keyword and value pair. This is 
often restrictive since long character lines 
are a pain to maintain. Most of the data- 
bases that I construct allow you to continue 
the data on the next line: 
# long line 
Long: This is a 

long 

long 

line 
Continuation is signalled by starting the line 
with white space - either a space or tab 
character, The reading routine will convert 
any newline characters into spaces and will 


consume any white space at the start of 
continuation lines. As a result the program 
will see the long line as: 


Long: This is a long long line 


There is one further trick that is worth de- 
scribing. Often a program will deal similarly 
with several different objects. If your pro- 
gram deals with different types of fruit, then 
you might have a line saying: 


Fruit: apple orange 


Each of these entities might have a charac- 
teristic that the program needs to analyse. 
If we wanted to talk about the colour of the 
fruit, | would add lines like: 


apple-colour: red 
orange-colour: orange 


The program dealing with this doesn’t 
know about apple or orange. It only 
knows that it is making an internal structure 
and should read a list of possible fruits from 
the Fruit line. Each of the space separ- 
ated entities will add a new category of fruit 
to be dealt with. Additional information 
about that category can be supplied by 
looking for keywords starting with the ca- 
tegory name. We can generate a new key- 
word using a sprint £ format of say: 


UNIX 
"Ss-colour" 


Additional lookups are now made to get the 
values of apple-colour and 
orange-colour. This scheme is very 
extensible. Adding a new category, say 
lemon, will not involve any program rec- 
oding. You simply change the Fruit line 
and add new keywords: 


Fruit: apple orange lemon 
apple-colour: red 
orange-colour: orange 
lemon-colour: yellow 


If you create a new program that needs to 
know something different about the fruit, 
then it’s easy to add a range of keywords 
derived from the Fruit line. 


Of course, in real life, programs rarely deal 
with fruit, but I hope that you get the idea. 


a 


EXE, 


Peter Collinson is a freelance consultant 
specialising in UNIX. He can be reached 
electronically as pe@hill- 
side.co.uk (although your mailer 
might be happier to put the address the other 
way round) or by phone on 0227 761824, 


Don’t Think 
Think 
DeadLock 


@ Price unbeatable 
® Technical 


@ Approved as the highest 
security available. 


Sits on parallel port. 
Programmable. 
Completely non-intrusive and transparent. 


Configuration 
Management 


PVCS and PolyMake for UNIX platforms... 


@ DEC 
Bull 
DataGeneral 


ICL 
Motorola 
NCR 
Nixdorf 
Prime 


The hardware component is based on a custom-designed IC. 


There’s full DeadLock support for today’s most popular 
languages compilers and development environments. 


DeadLock contains all the logic necessary for password control 
and to perform calculations. 


DeadLock comes with a special PROTECT utility that allows 
you to build an "envelope" of protection around your product's 
‘OM or EXE files. 


Each DeadLock key can be programmed by you , to transform 
it into a protection device that's unique to your product. 


Easy to use manual 
May be used for joint ventures. 
DeadLock comes with a variety of friendly, menu driven utilities. 
Please address all enquiries to: 
B.L. Computer Security Limited, 101 Hendon Lane, 
Finchley, London N3 3SH 
DeadLock 
P.O. Box 2543, London N3 3UA, England 
Fax: 081-346 2672 Tel: 081-343 0734 
Northern Ireland Tel: 0232 682 047 
All Trade Marks acknowledged 


Siemens 


Unisys 


and others... 


Readmar Systems 
Le scala (Noe lhe al Pecsel jaed O) 


Tel (+44) 071 625 5255 
Fax (+44) 071 624 9404 


CIRCLE NO. 504 


CIRCLE NO. 505 
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BITON 


THE 


CLIPPER 
ORACLE 
LIBRARY 


New for April ’92 the FoxPro 2.0 Oracle Connections | 


CLIPPER - BITON - ORACLE GIVES ACCESS FROM PC TO 
ORACLE ON - MAINFRAME - MINI - OS/2 OR STANDALONE PC. 


INTERESTED IN BITON? 
RING: UK (0727) 50658 FAX: UK (0727) 830111 


CLIPPER IS A TRADEMARK OF THE NANTUCKET CORPORATION. ORACLE IS A TRADEMARK OF THE ORACLE CORPORATION. 


CIRCLE NO. 506 


PC Security from Microft Technology. 
MENUGEN 


MENUGEN provides a password protected menu interface. The system 
manager has complete control of what each user is permitted to do. Access to the DOS prompt 
can be prevented. MENUGEN has no memory overhead. £48 + VAT. 


CLAM 


CLAM provides TOTAL security. It incorporates MENUGEN and D-LOCK. 
In addition it provides a number of other facilities, the most important of which is file encryption — the only 
way to provide a high level of security on a micro. £148 + VAT. 


D-LOCK prevents access to the hard disk after booting from diskette. £38 + VAT. 


S-LOCK 


S-LOCK clears the screen and locks the keyboard after a specified period of inactivity or on request. 
The screen is restored and the keyboard unlocked only when the correct password is input. £38 + VAT. 


Security Consultancy. 


A professional computer security consultant can help you determine the steps 
required to protect your computer information and systems. The options offered range 
from a fixed price risk analysis with action advice to a full security audit. 


Microft Technology Limited 
The Old Powerhouse, Kew Gardens Station 
Kew, Surrey TW9 3PS. 
Telephone: 081-948 8255 CIRCLE NO. 507 


Anti-virus software is also available. Corporate licences are available for all products. 


...................................................... 
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Books 


Books 


Just to show we're not completely xenophobic C freaks - here’s a PROLOG book. 


Well, I do declare! 


PROLOG - From Formal Specifica- 
tion to Prototype. After reading the title, 
you might be forgiven for expecting 
this to be an advanced PROLOG text, 
but it isn’t. As the blurb on the back 
cover explains, the purpose of the 
book is to introduce the procedural 
programmer to the ideas of declarative 
programming. That’s rather a mouthful, but it means that if you 
know a language such as C or Pascal, and you want to learn more 
about PROLOG, then this book should be for you. 

As a book for PROLOG beginners, there are some rather useful 
features included in the text. There is a liberal sprinkling of 
exercises, along with solutions in an appendix. Throughout there 
are worked examples and ‘Practical Activities’. These are mostly 
practical PROLOG sessions of the ‘type this’ variety, along with a 
commentary to explain the results. What if you don’t have a 
PROLOG system? Well, for a few pounds, the authors will send you 
aPC disk. On it will be a ‘no-frills’ PROLOG interpreter for MS-DOS, 
as well as many examples of PROLOG code from the text. As a 
bonus, the ubiquitous EMACS editor has been included. Although 
the interpreter was a little fragile when running on my system, it 
does give you the opportunity to see the book’s examples running, 
and at very little cost. This forms a valuable adjunct to the book. 

The book’s introduction to PROLOG is unusual, and perhaps 
startling. All programmers should be familiar with formal specifi- 
cation of an operation. Such a specification will usually include a 
list of parameters, a method, and a description of pre-conditions 
and post-conditions. Fewer programmers will be familiar with the 
notion of specifying the complete operation by these conditions 
alone. In the book, we learn that if these conditions are specified 
using PROLOG, then you don’t need to worry about the functional 
details of the operation; PROLOG will do the rest. In other words, 
if you exactly specify the pre- and post-conditions of an operation, 
PROLOG will find values to satisfy those conditions. There is no 
need for the programmer to tell PROLOG how to find the values. 
As the title of the book implies, PROLOG provides the missing link 
between the formal specification of an operation and a working 
prototype. 

With this blockbuster out of the way, much of the remainder of 
the book provides what you would expect from any PROLOG text. 


The bonus is that there is a strong ‘hands-on’ emphasis. Many (but 
not all) of PROLOG’s primitives are introduced and explained as 
more complex examples are worked through. However, we are 
saved from the usual descriptions of expert systems and inference 
engines, Similarly, there are no travel planners, or draughts playing 
strategies, although there is a hint of natural language parsing. 
Sadly, just when you thought it was safe, the very last chapter is 
devoted to the ‘Towers of Hanoi’ problem. Yes, I know it is an 
excellent example of a problem with a succinct recursive solution, 
but if it is the only example, then recursion can’t be all that useful, 
can it...? 

How does the book deal with some of the more difficult aspects 
of PROLOG - backtracking, the cut, and procedural versus decla- 
rative meaning, for example? An explanation of backtracking ine- 
vitably means resorting to a diagrammatic representation of the 
CALL-FAIL-REDO-EXIT cycle, and the search tree. A few years ago, 
the Open University developed an excellent notation for both 
called the AORTA diagram. All three authors work for the OU, and 
yet they have not used AORTA diagrams, but less inspired ‘engin- 
eering’ boxes of their own. These work for the examples they have 
chosen, but for more deeply nested problems, I think there would 
be trouble, The cut is also explained using diagrams of their own 
design. Although the basic message ‘green cut good, red cut bad’ 
does come across, I would have liked more examples. Procedural 
versus declarative programming is dealt with by comparing Pascal 
and PROLOG implementations of the same problems. This links 
nicely with the notion of using PROLOG for formal specifications 
described earlier. 

It is almost inevitable these days for such a book to include a 
chapter entitled ‘Object Oriented PROLOG’. Accompanying this on 
the disk is OBLOG. What a tantalising but frustrating glimpse this 
is. I was certainly left wanting more. 

In summary, if you want to learn PROLOG, this isn’t a bad place 
to start. You'll frequently be left wanting to go further, and to do 
that, you'll need one of the reference texts. If you’re an experienced 
PROLOG programmer, there’s little here of interest. 

Review by Dr Gareth Blower 


Title: PROLOG - From Formal Specification to Prototype 
Authors: Peter Leadbetter, Peter Thomas & Ray Weedon 
Publisher: Blackwell Scientific Publications 

Price: £17.50 

Pages: 384 

ISBN: 0-632-03161-1 


Books Received This Month 
Designing Your System with SmartWare II by M Gandoff & M Hicks Butterworth £19.95 ISBN: 0-750-6-0425-5 pp330 
The Design of OS/2 by HM Deitel & MS Kogan Addison Wesley $32.25 ISBN: 0-201-54889-5 pp389 
The Standard C Library by PJ Plauger Prentice Hall £29.95 ISBN: 0-13-131509-9 pp498 
DECnet Phase V-An OSI Implementation by J Martin & J Leben Prentice Hall £30.95 ISBN; 0-13-203118-3 pp572 
Programs and Data Structures in C (2nd Ed) by L Ammeraal Wiley $14.95 ISBN: 0-471-93123-3 pp272 
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CUG 


Let Me Explain 


In the first of a new regular slot, Francis Glassborow tells us all about the C Users Group. 


Let me start by introducing myself. I am the 
Editor of CVu which is the journal of the C 
Users Group (UK) as well as being the 
Chairperson of that organisation. Unlike many 
editors of Special Interest Group publications 
receive more material than the group can 
afford to publish. 


I do not intend to fill the space that the Editor 
has provided with never-ending reasons why 
you, the reader, should join CUG(UK). Nor do 
intend to waste your time and my space by 
isting events from our calendar unless they 
are of more general interest. This time I will 
tell you a little about us and our aims. In future 
I will tackle items that should interest 
programmers using C and its successors. I 
hope that some of what I write will be of a 
more general interest. 


Let me tackle our title. The ‘C’ includes C++, 
Objective C, Concurrent C and other current 
and future developments in this area of 
programming. We do not believe that C is in 


some way special, just that it is an excellent 
language for many purposes. 


The ‘Users’ includes the entire scale from 
enthusiastic amateur just starting to the 
long-term experienced professional 
programmer. It also includes those that 
provide the tools that we use, those that offer 
training and those that develop and monitor 
standards.‘Group’ is one of those all 
embracing terms that avoids some of the 
overtones associated with ‘Club’, ‘Association’ 
etc. Some aspects of the group do resemble 
those of a club. Members want to share their 
interest and insights, they enjoy the sense of 
belonging and indulge themselves with’ 
disagreements. On the other hand members 
are supportive of one another, they are willing 
to share experiences and insights and to 
provide help and advice when they can. 


All of us need support occasionally, It is rarely 
as severe as the young programmer who rang 
me last year in despair because he could not 


see how to meet his employer’s demands 
within the time-scale set. A quick hunt round 
and I was able to point him towards a UNIX 
tool that achieved the desired result in half the 
time allowed. The sense of someone else 
caring and supporting him in his moment of 
need was much more valuable. 


The (UK) is simply to distinguish us from an 
American organisation that uses the same 
initials, 


CUG(UK) has existed in its present guise since 
1987. Its primary aim is to support members 
in developing their programming skills along 
sound but not dogmatic lines, 


EXE! 


For information about CUG(UK) write to 64 
Southfield Road, Oxford, OX4 LPA or ring 
0865 246490, Individual membership is £12 
and £50 for company membership. 


-s 


FEBRUARY .EXEWORD * 


bb 21 He charged French dish (7) 


25... cryptic program? (4) 


28 Whatn ands do (7, 


~ Absolute or indexed, say (10) 


ACROSS 


1 Nearly all applied solid-state physics (4) 
3 Suffering at work from too large a current (10) 


10 Container in backward phone measures may digitise (7) 


11 Source of electrons in gun (7) 

_A2~ Thpeak thtrangely in some language (4) 
13 Erase an eprom (9) 
15 Crappy age where is many a game (7) 
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current (7) 
21 Become delayed and let free in 
logic unit (3,4) 
aie Needs two positive inputs for 
success (3,4) 


24 The first modern computer (1942) (5) 


26 Make no change about 30 (4) 


“EXEWORD’ compiled by Eric Deeson 


9 Voracious creatures in popular game (8) 


nie Assign greetings to Catherine, | hear (8) 
19 Format where satellites go? (7) 
20 Varnish part of OS with alternating 


Aquatic mammal worker may block the leak (7) 
18 How the conductor opposes the current (7) 


23 In banking or police computer maybe a line of ...(9) 
27 Opening character in one confused ending (7) 


29 Milliards of Tebbit's vehicles? (10) 
30 International at the end of a coding exercise (4) 


DOWN 
1 Hide behind a set of bits (4) 
2 Where to work on a network (7) 
_4A~ Type of system we need the latest of (7) 
5 Writes the parts of a file (7) 
6 Chosen from a drop tediously poured (5) 
7 Jovian moon in a play in a 3D set (7) 
8 Insulator with such a constant (10) 
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DECEMBER .EXEWORD 


How many users of your software paid for it??? 


SOFTLoK International Limited was established in 
1987 with the introduction of our SOFTLoK and 
SOFTLoK PLUS devices to combat the ever 
increasing problem of software piracy. Our 
SOFTLoK range of software protection devices are 
used by hundreds of software developers from 
small consultancies to large multinationals. To cope 
with the ever changing needs of our customers we 
have developed SOFTLoK II which combines the 
programmable features of SOFTLoK PLUS with a 
low unit cost similar to our original SOFTLoK 
product. 


SOFTLOK IF 


The Next Generation 


SOFTLokK II units are programmable devices 
containing read/write memory protected by a 
password. Both the memory and the password 
can be changed at any time using our routines 
in your application software. Easy to use menu- 
driven software is provided to allow small or 
large batches of SOFTLoK II units to be 
programmed with their initial data & passwords 
ready to be sent out with the protected software 
product. 


Price: 1-19 £1 6.90, 20-49 £15.40, As SOFTLOoK II units plug into the 
50+ £13.70 parallel printer port they can be installed 
or removed in seconds. 


Evaluation kit £20 (SOFTLoK II, manual & software) 
All prices excl. VAT and delivery 


For IBM PC, PS/2 and compatibles 

Uses parallel printer port 

Totally transparent to printer 

Secure data & password can be changed from your application software 
Cascadeable 

240 bytes of secure read/write memory 

8 byte (64 bit) password 

No programming adaptors required 

Easy to use SOFTLokK II setup software 
Routines ready to link with various compilers 
Easy to follow manual 


OCoooooococaca 


I-MEX House, 40 Princess Street, 
Manchester, M1 6DE, England, 
Tel: 061 228 7379 Fax: 061 236 6890 
[_OIRCLE NO. 508 |] 


SIFIED...CLASSIFIED...CLASSIFIED...CLASS 


To advertise in this section, please call Marc Warren on 081-994 6477. Fax 081-994 1533 


Features 
Fast, reliable operation 
Compact and ROMable 
PC Peripheral support 
DOS file access 
Cand Assembler supported 
Preemptive task scheduler 
Time slicing available 
Configuration Builder 
Intertask messages 
Message exchanges 
Dynamic operations: 
- create/delete tasks, timers 
- adjust task priorities 
- memory allocation 
Buffer Manager 
Semaphore Manager 
Breakpoint Manager 
Sample and Demo Programs 
InSight™ Debug Tool for use with most 
popular debuggers 


Event Manager 
List Manager 


Give Real-Time Projects a Head Start 
with the AMX™ low-cost high performance Multitasking Kernel 


Targets 


AMX 86 for real mode 80x86 
AMX 386 for protected 80386 
AMX 68000 for 680x0 

AMX 80 for Z80, 64180 and 8085 


No royalties 
Source code included 


For more information and a free demo disk 
contact: 


ScotWare Ltd 

45 Frederick Street Tel; 031-225 4858 
EDINBURGH Fax; 031-220 3550 
EH2 IEP 


Real-time and database software specialists 


braiiay 


SYSTEMS (UK) LTD: 


Motherboards 

386SX25 £130 wicache £150 

386DX33 128K Cache £265 

486DX33 256K Cache £495 
A D F 


80486-33 256KB Cache Mini Twr 

4MB RAM - 3.5" + 5.25" Floppy 

120 MB Hard Disk 

2 Serial 1 Parallel 1 Game Ports 
Trident 512 KB VGA Card (1MB option) 
UK Keyboard (102 Key) 

£1299 exc VAT and Delivery 


Call Keith Hickson 
Tel: 071 734 5783 
Fax: 071 734 7256 


Offset-Litho 
PRINTING 


Design, Editing, Graphics, Printing & 
Binding facilities, Fully computerised, 
we complement your skills and can 
use your ASCII or DTP files to keep 
costs low, 

e@ Manuals 

e Leaflets 

e@ Labels 

e Stationery 


Fast and Effective Service 


Please note our number as this advert 
does not appear every month 


0457 871022 


Domino Press 
Lawton Square, Delph, Saddleworth OL3 SDT 


Pees <t) 


COMPUTERS 
COMPUTER PARTS 


PLOT TH 
DIFFERENCE 
PLOTVIEW 


Ise srg ow cont aerate te 
er ets Ase pene pte 


tears seen wien ees eeeey 
PLOTVIEW 
ey nerve ONE 


Lag Phone now for more details about PLOTVIEW: 


as 1925 separate tes 


, to your productivity. 


CAMEL SERVICES LTD. 
Telephone OXFORD (0865) 512678 


TROTWEW tows pees ptieg aa 
tepetien = ong craps ere 


the versatile tool that can really make a difference 


Version Control 


PVCS* £345 
MKS RCS £155 
SMS £385 
Sourcerers App — £169/399 
TLib £95 
Editors 
PVCS Editor (SPE)* £175 
QEdit £45 
Brief £189 
Epsilon £169 
PVCS Make* £149 
MKS Make £95 
Opus Make £89 
Others 
SourceDoc* £199 
PolyLibrarian £175 
Demo II £175: 
386/BlueMAX* — £69/£85 
SegMentor* £1695 
Readmar Systems 
Tel 071 625 5255 
“Distributor ACCESS/VISA 
— 


KIBWORTH 
COMPUTER TRAINING 


Save time by learning 


Cor C++ 


with customised tuition in 
an ideal environment. 


Phone or write for details: 


68 Springfield Crescent 
Kibworth Beauchamp, 
Leicester LE8 OLH 


Tel: 0533-792653 


Object T F 
Oriented U S 
Real for R (o 
Time B A 
K ernel (e) L 


OORTK is an object library for 
versions 5.5 and 6.0 of Turbo Pascal 
allowing the application 
programmer to develop real time 
and commercial systems using a 
multitasking approach on PC and 
PS/2 compatible computers. 
OORIK is the first product of its kind 
for Turbo Pascal and is in use in 
several countries throughout 
Europe. Applications produced 
using OORTK may be distributed 
royalty free in .EXE form. 

OORITK provides multi-threading, 
multiple prioritized — tasks, 
semaphores, mailboxes, queues, 
an ADA style rendezvous and 
many other facilities allowing 
development of a wide range of 
applications, The kernel occupies 
very little memory and the 
application programmer has lolal 
control over the use of system 
resources. 

OORTK costs £97.50 plus £5 delivery 
(UK) plus VAT. Special terms and 
prices are available for 
Educational users. 


Dealer enquiries welcome! 


For more Information write to: 
JPS Graphics, 3 Glynne Street, 
Queensferry, DEESIDE, CHS 1TA 


Telephone or FAX on 0244 821009 
All trade marks acknowledged 


- Graphics & Microprocessor 
Systems Design 


just 
If 
BOOKS 
e Struggling with Sage? 
e Dicing with DOS 5.0? 
e@ Worried by WordPerfect? 


From beginner to expert 
We have over 3000 titles to 
choose from. 
Please phone or write for 
your FREE catalogue 
11 Court Rd. Malvern 
Worcs. WR14 3EF 
B (684-568095 


The Secret 

of Successful 
Advertising 
is..... 


To find out how you can reach 
17,000 professional developers 
for as little as £85, call 
Marc Warren on 081 994 6477 


The Babelfish Paradox Data ) 
Driver for Clipper Summer 
’87 and 5.0x versions. 


Call Now for 
a free Demo 
Disk. 


QBS Software Ltd 
10 Barley Mow Passage, London W4 4PH 


Tel: 081 994 4842 
Fax: 081 994 3441 


Ne 


SIFTED... CLASSIFIED...CLASSIFIED...CLASS 


To advertise in this section, please call Marc Warren on 081-994 6477. Fax 081-994 1533 


Type & PostScript 


PostScript Interpreters: from £4 to £4,000 
Fountain, GoScript, Freedom of Press, Ultrascript, 
PS Tutor, LincPage, NTG2000, Watland Orb 
PostScript LaserJet Upgrades from £239: Adobe, 
HP, Pacific Page, UDP TurboScript 
PostScript Utilities: ATM, PSFx, PSPlot, Books 
Type 1 Fonts from £3 to £3,000: Public Domain, 
Adobe, ZSoft, Digi-Duitl, Watland Orb 
HP Bitmap Fonts: ZSoft, Typogratica, Digi-Duitl, 
‘Atech, DTS, Watland Orb, Tailor Made 
Laser Printer Memory Upgrades: HP, Canon, IBM 
Custom Fonts & Logos: HP Bitmap, Type 1, EPS 
Custom HP Font Cartridges: from £90 (10 off) 

If you need to print Cyrillic, Turkish, or Classical 
Greek, or need design consultancy, then call or fax. 
We have good prices on a sensible range of print 
and graphics products: we also put together very 
fast, reasonably priced PCs. 


David Pollard Associates 


Folly Bridge Workshops, Thames Street, 
Oxford OX1 1SU 0865 240048 Fax 792277 


ORCHID 
WORKSTATION 


Orchid ‘486/33 Motherboard 
Orchid Fahrenheit Video Controller 
NEC MultiSynch 4FG Monitor 
Big Black Box, Cherry Keyboard 
16 MB, Single Floppy: £2469 +vat 
Motherboard + Fahrenheit: £1050 


HDD, second FDD, tape streamer 
SCSI controller etc. at trade cost +7% 
The Orchid has a 32 bit direct video data path 
and the controller is faster than standard VGA, 
Compared with an ordinary '486, Windows 
applications run 18 times faster on the Orchid, 


David Pollard Associates 


Folly Bridge Workshops, Thames Street, 
Oxford OX1 1SU 0865 240048 Fax 792277 


Security Guide 


Data Protection and Security 
for Personal Computers is a 
guide for support staff and 
managers. Everything you need 
to know about: 


e Keeping viruses out of your 
company. 


Drafting and implementing 
a corporate data security 


policy. 


Persuading staff to take 
regular backups that are 
known to be reliable. 


Detecting and eradicating 
software piracy. 


Includes comprehensive 
product guide and lots of 
trouble-shooting advice. 


The price of £145 includes 90 
days’ free telephone support 
from the author. 


Please call TTK Technical 
Publications on 081 995 9845 
for details and a free brochure. 


DO YOU NEED 
MORE MEMORY? 


We have three libraries to 
give you just that! 

XMEM - Virtual inemory Manager using 
base, Expanded, Extended or Disk. Replaces 
malloc. £145 
MEMORY TOOLK! 


~ Library of routines to 
manage Fapandee and Extended memory 


plus big DOS arrays. £95 
EMPTY SHELL - C routines for freeing up 
memory when shelling to a sarge gfeatam. 
Uses EMS, XMS or disk to swap. £165 
@ nit tm_ Farrington Fields 
Farrington Gurne' 
Ee Bristol BS18 5U 
Tel 0761 452116 
3 Fax 0761 453226 
c VAT Extra Carriage Free 


Comeuter 
MUS C systems Ltd 


5-7 Buck Street, 
London NW1 8N)J. 
071-482 5224 


\” Voyetra Sound Factory™ 


Sound Factory™ is a complete audio development kit for 
DOS or Windows 3, from Voyetra, the leaders in IBM 
music software. Containing drivers for a wide range of 
sound cards, digital audio boards & MIDI interfaces, 
Sound Factory™ gives developers as wide a market 

as possible. Call or fax us for further details. 


We also stock a wide range of PC software and peripherals. 


Specialists in Music Software 


Wedowsinbwines, "FREE CATALOGUE 


icONWORKS 


Database reports made easy 
for dBase, Clipper and 
compatibles. Also for Paradox, 
123s and Quattro Pro. 


Turn raw data into useful 


information using Lotus like 
commands and menus. 


Available from 
QBS Software Ltd 

10 Barley Mow Passage 
London W4 4PH 

Tel: 081 994 4842 

Fax: 081 994 3441 


Call for free demo disk 


windows 
SHAREWARE 


eo AA Different Approach va i 


HO Business Upgrades Custom 
UCOMWORKS tokes a different approach to the 
distribution sharewore for Windows... 
HIGH DENSITY DISKS FREE UBGRADES i 
By compressing on average —_ Most of our disks con be 
of 20 programs onto HD disks retuned with your next order || 
‘wo offer extremely good ——_for 0 free upgrade, i 
CUSTOM DISKS | 
\Wo con buid up dks to oro | 
from your choice of over 650. | 
‘oppications ulities and fonts, |: 


TELEPHONE OR WRITE FOR A | 


volue for money. 
BUSINESS SOFTWARE 

We supply 0 wide ronge of 
‘applications and utilities 
which ore designed to meet 


22 Hope St 


tar 
LAL 38a 
0524 39283 


WORKSTATION MEMORY 
SUN 4 COMPATABLE MEMORY 
4(20/SCL 4Mb £200 
SPARCSTATION ELC 4Mb £200.00 
16Mb £675 
4/40 (IPC) 8ONS IMb £44.00 
TONS IMb £48.00 
8ONS 4Mb £165.00 
TONS 4Mb £184.00 
SPARCSTATION IPX  4Mb_— £200.00 
16Mb £675.00 
4/60 SPARCSTATION 1 IMb £44.00 
4Mb — £165.00 
4/65 SPARCSTATION 1+1Mb £44.00 
. 4Mb £165.00 
4/15 SPARCSTATION 2 4Mb £165.00 
4/110,150 IMb £44.00 
4/260,280 8Mb £1870.00 
16Mb £2300.00 
32Mb £395.00 
4/330 8Mb £740.00 
16Mb £1205.00 
32Mb £2250.00 
64Mb £4140,00 
4/370,390 4Mb £165.00 
4/470,490 32Mb —£POA 
128Mb £POA 
SUN 3 COMPITABLE MEMORY 
3/50, 3/52 4Mb £475.00 
8Mb £765.00 
4MB £305.00 
SMM TOOL KIT £35.00 
3/60, IMb £44.00 
3/80 IMb £44.00 
3/75,110,140,150,160,180 
4Mb £750.00 
8Mb £975.00 
12Mb £1300.00 
16Mb £1620.00 
20Mb £1950.00 
24Mb £275.00 
3/260,280,470,480 8Mb £1870.00 
16Mb £2300.00 
32Mb £3885.00 
3E120 4Mb — £505.00 
8Mb £785.00 
12Mb 1075.00 
SUN 386 WORKSTATION MEMORY 
386i, 150 IMb £44.00 
386i, 150x,250 IMb £44.00 
APOLLO DN MODELS 
DN2500  80NS IMb £44.00 
TONS IMb £48.00 
DN3000, DN3010 2Mb — £280.00 
DN3010A,3040,3500,3550,4000,4500,5500 
4Mb £370.00 
8Mb £630.00 
HP 400 SERIES 
HP9000/400,400d1,4001,425t,400s,433s 
4Mb £345.00 
8MB £740.00 
16Mb £1335.00 
32Mb £2540.00 
HP APOLLO 9000/425E 
4Mb £355.00 
8Mb £725.00 
16Mb £1200.00 
HP APOLLO 9000/700 
8Mb £990.00 
16Mb £1485.00 


32Mb £3940.00 
IBM COMPATIBLE MEMORY RS6000 
RS/320/320H,520,530,550,730,930,950 


16Mb £1250.00 
32Mb £2290.00 
64Mb £4390,.00 
APPLE COMPATABLE MEMORY 
Mac IL IIx,Iex. 1Mb £42.00 
SE,SE/30,PLUS,CLASSIC, 
LCi, IIsi 4Mb_ £170.00 
Mac IIfx. 4Mb — £200.00 
16Mb £825.00 
SILICON GRAPHICS COMPATIBLE 
PERSONAL IRIS 4D/20,25 
IMb £44.00 
4Mb £165.00 
PROFESSIONAL IRIS 4D/S0,70,80,85 
1Mb £44.00 
4Mb_ = £165.00 


POWER SERIES 4D/120,210,220,240,280, 
310,320,340,380 2Mb = £135.00 


NEXT COMPATIBLE MEMORY 
NEXTcube,NEXTstation 1Mb £42.00 
4Mb £170.00 


SABREBANNER 
Tel 0532 854521 


VISA, Access & MasterCard Taken 
Fax 0532 853026 


Please call us on 081-994 6477 


eAE 


RONICOM 


RECRUITMENT 


5-7 Sedley Place (off Oxford Street), London W1R 1HH 
Tel: 071 491 3640 Fax: 071 499 2546 


TEAM LEADER 
SW London up to £25k + Bens 
OSI skills - X25 - X400 - a good coding back- 
ground in C is essential for this quality software 
house, a good knowledge of Windows 3 would be 
of benefit. 


SOFTWARE ENGINEER 
SW London up to £19k 
Windows SDK, good calibre C, some networking, 
X25 in an O.S.I. environment, you should have at 
least two years experience. 


SYSTEMS SOFTWARE ENGINEER 
Herts £neg + Bens 
A quality 4GL software house is looking for a 
UNIX, C, UNIPLEX background in an X-Windows 
environment, you must have good DOS skills with 
shell & kernal ability - perhaps even some X400? 


CAD EXPERIENCE 
Kent up to £20k 
Geosecma, Landcadd development and tailoring - 
possibility of European work, 


C++ WINDOWS ASSEMBLER 
Berks up to £20k + Car 
Good development skills are required for this inno- 
vative Windows software house; young, extremely 
competent and enthusiastic please. 


OS2 - WINDOWS SDK-SQL 
W London up to £27k 
An intriguing development that will create great 
prospects, the current products are good and the 
projected products look like they will do very well. 


OSF MOTIF - X WINDOWS - C 
Cambs Good + Bens 
Good development engineers are required for this 
UNIX Windows software house. Some client con- 
tact tailoring is expected, so you should not be too 
shy an individual. 


LOW LEVEL BIOS C 
Surrey £18k + Bens 
BIOS MASM TASM Device Drivers TSRs your 
bag? Any 80x86 driven assembler, then this PC 
manufacturer will offer you a bright future! 


If any of these positions are at all suitable, or 
even if your skills are not quite what is required, 
do not hesitate to give Mike Dearing a call on 
071 491 3640 or after hours on 081 767 1003 


Specialists in relational databases, open systems and structured techniques, 


ORACLE/SQL/ 
EMBEDDED SQL 


Candidates with skills in SQL and embedded 
SQLareimmediately required by clientsinvolved 
in applications as varied as financial information 
systems to pan European manufacturing/ 
distribution and leasing systems. Strong SQL 
experience coupled with low-level language 
interfaces to3GL’s and screen painting methods 
are important. Training in the latest Oracle tools 
and methods given where necessary. The new 
and existing implementations are running under 
VMS, ULTRIX, UNIX andsunOS with some links 
to multi-user PC systems. Other database 
knowledge may also be of interest. 
£12,000-35,000+ 


Riot SC/1/.exe 


SOFTWARE DEVELOPERS 


INGRES 


Excellent opportunities exist for any INGRES 
development staff from Programmers up to 
Project Manager level. Candidates will be using 
the most advanced development tools available 
with companies investing in leading edge 
technology. INGRES/STAR, GUI's, SQL and 
OPEN SQL, decision support/application 
development tools, user interfaces and 
structured methods (SSADM, YOURDON, 
JACKSON), C, COBOL, are the priorities 
Potential to work across varied hardware 
platforms is also a preference. Opportunities 
exist in Banks, Building Societies, Software and 
Systems Houses and Governmental Bodies. 


£12,000-35,000+ 


Ret SC/2/.exe 


DATABASE DESIGN 


SYBASE, INGRES, INFORMIX,ORACLE, UNIFY,CLIPPER, PRO IV, POWERHOUSE, RDB, ALL, 
SEACHANGE, PROGRESS, SB+, INFORMATION-and interfaces to 3GL’s - C, C++, PASCAL and 
FORTRAN and even COBOL and BASIC! Our client companies require candidates with the following 
skills: Technical Software Development, Software Engineering, Pre/Post Sales, Database Design and 
Systems Consultancy. Areas of particular interest include: Distributed Ss, Object Oriented 
Databases, LANS, WANS, Graphics Image Processing, Windows, Formal Design Methodologies, 
CASE Tools, Expert Systems, Knowledge Engineering, Office Automation, Compilers, Low Level 
Design, Data Integration and varied application design. COMPUTER POLYGLOTS need apply! 


C/UNIX/MS-DOS 


Manufacturing, Commercial, Scientific and 
Government application environments alike 
fequire excellent C skills. Low-level machine 
knowledge, operating systems internals, and 
use of debuggers/compilers are required. 
Software development experience is the key, 
and being able to deliver high performance, high 
quality, well specified software in competitive 
time scales. Opportunities vary from small 
software companies involved in expert systems, 
GUI's, Images Processing, GIS,EIS, 
Communications, Networking and Object 
Oriented Databases to large scale 
communication companies systems. Graduates 
through to senior software engineers/team 
leaders are required. UNIX internals and Kernel 
level knowledge are also very much in demand. 
£14,000-35,000 

Ref SC/3/.exe 


X WINDOWS/ 
MS-WINDOWS/MOTIF 


Graduates (1 year+) to Senior Software 
Engineers with an interest in advanced 
developmentenvironments need apply for varied 
positions with companies dedicated to leading 
‘edge technology. A mixture of the following skills 
in a development environment are preferred: 
GUI’s, Document Image Processing, OCR 
technology, Client/Server applications and 
WYSIWYG techniques coupled with experience 
of UNIX, sunOS, MS-DOS, or ULTRIX/VMS and 
Interfaces to relational (primarily INGRES or 
SYBASE) and Networking (TCP/IP, NFS, X400) 
technology. Application areas vary from Retail, 
distribution to finance and Software Vendors to 
End User environments. 


£12,000-35,000 + BENEFITS 


Ref SC/5/.exe 


SYBASE/UNIFACE 


£12,000-40,000 


Ret SC/6/.exe 


COMMUNICATIONS/ 
‘i NETWORKING 


Developments as varied as Voice-activated 
relational database recognition systems, 
Protocol enhancement at transport, session and 
presentation level and World-wide 
communications systems utilising LAN's and 
WAN's across different hardware platforms are 
currently available. ital of ETHERNET, 
TCPIIP, NFS, X25, X400, X500in a UNIX, VMS, 
‘sunOS and also fault tolerant environments are 
required. Some exposure to structured methods 
and other leading edge technology would be a 
bonus, though training will be given. Knowledge 
of industry standards and committees is also 
relevant at more senior levels. UNIX Kernel 
knowledge is at a premium. 
£12,000-£35,000 
Ref SC/4/.exe 


SOFTWARE ENGINEERS 


Clients-End-Users, Software Vendors and 
Software Houses dedicated to strategic 
implementation of leading edge technology and 
integration of applications across different 
hardware and operating systems platforms 
require candidates to degree level with a 
scientific/technical development bias and a 1-3 
ears’ experience. There are two main options:- 
ECHNICAL DEVELOPMENT: Continued use 
‘of UNIX, VMS, MS-DOS, C, Windows, Pascal, 
C++, Ada, Prolog, OOPS, Networking and 
Communications with companies offering 
technology based careers and management 
responsibility. 
COMMERCIAL DEVELOPMENT: Using 
technical skills already developed, but offering 
‘opportunities to apply analysis and design skills 
father than remain a ‘technical guru’. Please call 
to discuss your particular career path, growth 
and potential. 
£12,000-25,000 + BENEFITS 


Rot SC/7/.exe 


INFORMIX/CLIPPER 


Due to the continued expansion of the market for 
RDBMS as a multi purpose software 
development tool and particularly the 
adaptability of SYBASE, its popularity is growing 
in manufacturing, scientific, industrial, 
commercial and financial application areas. 
Clients throughout the UK and Europe require 
SYBASE experience in a VMS, UNIX and even 
PC environment. Again interfaces to 3GLs, 
Structured Methods and Communications 
Protocols are also important. Please call to 
discuss the varied opportunities at all levels, 
including setting up new development 
departments. 

£12,000-40,000 + BENEFITS 


Ref SC/8/.exe 


Clients involved in small to medium database 
projects (10 to 35 users) utilising products like 
INFORMIX, CLIPPER, DBASE IV and 
FOXBASE require Programmers Analyst/ 
Programmers with 4GLs, C, Pascal, Turbo 
Pascal, Quickbasic etc... or some of these skills 
for new and existing developments. Potential to 
get involved in Networking projects and in some 
cases larger scale projects involving 
cross-training also exist. 


£12,000-22,000 
STOP PRESS Ref SCI/.exe 


Pre/Post Sales UNIX Systems London, 
sau Syelene Consultant - Berk/Surrey/London. 
UNIX Systems Administrators - All Areas. 


CONTRACT AND PERMANENT POSITIONS ARE UK 
WIDE, SO PLEASE TO DISCUSS YOUR PARTICULAR 
SKILLS AND REQUIREMENTS. 


The Soft Corporation Chancery House 319 City Road 
London EC1V 1LJ Tel: 071 609 5501 Fax: 071 700 5787 


Job market flat???... 
.. shouldn’t you be in GIS?? 


G.I.S. is a rapidly growing application area of |.T. Public and 
Private sector users are investing heavily in G.I.S., many linking 
the database information from the G.I.S. with their existing 
database management systems. 


If you are a skilled systems and programming professional with 
experience of using Oracle, Ingres, Sybase or one of the newer 
OO DBMS toolsets for developing applications software, you 
should consider moving into G.I.S. Below are THREE current 
opportunities which illustrate the point. 


Database Analyst, £24000, West Herts 

If you have at least 2 years experience of developing database 
applications, ideally in Ingres under UNIX this world leader in 
GIS. will interest you. Your software will enable clients to fully 
integrate G.I.S. into their corporate M.I.S. 


Analyst Programmer, £22000, Maidenhead 


Your skills should reflect a detailed understanding of textual and 
graphical databases probably gained with a CAD system supplier. 
You should be fluent in C under both DOS and UNIX. 


Software Engineer, £19000, Reading 


You will join a team developing a new generation of G.I.S. You 
should be very familiar with SQL and C. Training in the products 
will take place in Australia. 


To apply for one of the above vacancies or to find out how your 
skills could be transferred to G.I.S. call ALAN CARNELL at 
Concurrent Appointments. 


27 FIELD CLOSE 
Concurrent HARPENDEN 


Appointments HERTS 
: Tel: 0582 712976 
Software Recruitment Fax: 0582 764858 


QUESTOR 


Computer Personnel 


PROGRAMMER N. Herts ¢, £12k 
Very highly regarded s'ware house with full order book needs an additional 
applications programmer, to work under Windows3 & PM. Around 1 year's 
commercial experience of C or a 4GL necessary. Contact P.H. 
TECHNICAL AUTHOR N.Cambs to £20k+ bens 
Leading edge software company seek a technical author with several years’ 
experience of writing with a commercial software bias. Exp' of projects from 
concept to completion, OS/2 - Windows or AS400 applications will be of 
added interest. Contact A.H. 
SENIOR FIRMWARE ENGINEER Bucks circa £22k 
Experience in high speed image processing using CCD technology, a high 
level language & 8086 & 68000 assemblers, combined with good PC 
knowledge. Contact P.H 
SYSTEMS SOFTWARE ENGINEER Middx to £26k 
To work on microprocessor-controlled systems. Relevant degree, 3-5 years 
commercial design/development experience on IBM PC & SUN equip' plus 
scope & logic analysers. Team Leadership useful. Contact P.H. 
NETWORK & SYSTEMS SUPPORT E. Herts £15 - 20k + car 
Growing IBM systems house & VAR require an experienced support analyst 
with sound knowledge of MS-DOS & Xenix in a networked environment. You 
will provide telephone and on-site support, system & network installations and 
network administration for clients on site. Contact T.S. 
ADA - PROGRAMMERS, 

ANALYSTS and DESIGNERS Surrey + others Neg 
With over 2yrs' experience in one of the above areas, you will ideally have 
experience with structured methods, Naval systems, performance critical 
s'ware or team leading. Contact M.D. 
CAD - OPERATOR Wilts £Neg 
With several years Autocad exp' and a mechanical design background this 
prestigious company requires good candidates to work in a buildings services 


Regal House 
55 Bancroft Evenings: 
Hitchin 

SG5 1LL. Alan Hewson 


Tel : 0462 438373 0462 459338 
Fax: 0462 421272 


WEST 
YORKSHIRE 


Trainers for accounting 
and admin software £12,000 


Project Installation Manager (UNIX) £14-16,000 


Trainers & Programmers for PROGRESS 
AGL/MSDOS & UNIX environments . 


4GL Analyst Programmers to work In 
UNIFACE/SYBASE/ULTRIX environment ... to £15,000 


TAS 4GL Support Programmer 


v1 £12,000 


‘C’ & 8086 Assembler Programmer ........ f0 £15,000 


Clipper Analyst Programmer 
with *C’ on Novell to £15,000 


Programmer/PC Support, Clipper, 


dBase or Sycero DB... «1. £11,000 


For your next career move around West 
Yorkshire telephone Vincent Atherton on 
Leeds (0532) 504560 or write to: 


AIREDALE RECRUITMENT 


Realtex Hs., Micklefield Lane, 
Rawdon, Leeds, LS19 6AX 


AIREDALE 
RECRUITMENT 


PC Software Localisation 
& Test Specialists 


C : DATABASES : SQL : MS-WINDOWS 


Superb opportunity to be a founder member of a specialist team created 
to localise a leading Windows database system for European markets. 
Conveniently situated near Oxon/Berks border. 


PROJECT MANAGER to £35,000 
TEST TEAM LEADER to £27,000 
SOFTWARE ENGINEER to £24,000 


We are seeking candidates who are familiar with the development and 
usage of translation tools/kits and with the test processes involved in 
the translation of baseline products into local languages. Technically, 
you will have considerable experience of PC Databases, MS-Windows 
and be fluent in C. Exposure to product release mechanisms in a fast 
moving software publishing company would be a distinct advantage. 
Above all, candidates should be graduate calibre, results orientated 
and enjoy working in a technically stimulating team environment. 


If you feel you are capable of rising to the challenge of these existing 
career opportunities please telephone David Adcock on (0865) 
742456/7 or send your CV to Haybrook Appointments, Suite B, 
Regal Court, 112 London Road, Headington, Oxford, OX3 9AU. 


Haybrook 


APPOINTMENTS 
PC Recruitment Specialists 


UNIX AND 
WINDOWS 


Unix System Support 
South London 
£20,000 + car + benefits 


This highly successful international hardware 
vendor are seeking a Unix Systems Support 
person to be involved with leading edge 
technology. This opportunity is varied and 
challenging and covers 2nd line client support, 
pre-sales, demonstrations and evaluations of new 
products. Your background will include 2 years 
experience of Unix product support or large 
systems support and technical fluency with Unix 
to Kernel level. You are educated to ‘A’ level 
standard and have excellent communication and 
interpersonal skills. Ref: PCEX15/1 


Ingres/Oracle Analyst 
Programmers 


London/Surrey 
to £26,000 + benefits 


A prestigious retail outlet, based in Central 
London, is currently seeking a senior analyst/ 
programmer to be involved with the new 
development of in-house systems. With extensive 
UNIX and Oracle skills the ideal candidate will be 
experienced in all phases of the project cycle 
including structured development and analysis. A 
solid understanding of database techniques and 
excellent social and interpersonal skills are 
fundamental to this role. Alternatively, a leading 
software house, based in Surrey, urgently require 
Ingres analyst/programmers to be responsible for 
the development of commercial systems. If you 
have a minimum of 2 years Ingres under UNIX, 
this company can offer you ongoing training and 
enhancement of your skills in a stimulating and 
challenging work environment with genuine 
prospects for career progression. Ref: PCEX15/2 


For further details of these and other permanent vacancies, 
please contact S. Atkinson, quoting the relevant reference, 


on 071-734 4010 (office hours) or 071-431 2316 


(evenings/weekends). Alternatively, write to McGregor 
Boyall, Sutherland House, 5/6 Argyll Street, London 


WIV LAD, or fax your CV on 071-734 1297. 


Windows and ‘C’ Developer 
The City 
to £20,000 + benefits 


This young and rapidly growing financial software 
house is currently seeking a Windows applications 
developer with at least one years’ SDK 
experience. You will have at least two years’ 
Windows 3 experience and solid ‘C’ skills gained 
in a commercial environment. Project work will 
include full involvement from initial specification 
through to implementation. Enhancing the 
Windows experience of the current team, you will 
apply your knowledge to exciting financial 
developments and gain valuable experience in the 
process. This is a genuine opportunity to grow 
with a dynamic and merit based company. 

Ref: PCEX15/3 


Oracle Analyst Programmer 
Central London 


£16-20,000 


In line with its intention to implement an open 
systems strategy, utilising HP9000 Unix boxes, 
this prestigious Central London consultancy 
currently has a requirement for two Oracle analyst 
programmers. These positions will be of particular 
interest to candidates whose ultimate career 
ambitions lie in the area of consultancy as such 
options are available once the internal systems 
migration has been completed. As a result, 
candidates must combine both strong technical 
skills — a minimum of 18 months Oracle 
development in a Unix environment - with 
excellent interpersonal and presentation skills 
and a good academic record. Graduates are 


preferred. Ref: PCEX15/4 


mcegregor 
ee: boyall 


IT HUMAN RESOURCING 


FOR PERMANENT AND CONTRACT IT RECRUITMENT, TELEPHONE 071-734 4010 


ASH ASSOCIATE 


We specialise in the Recruitment of Software Design and Support 
Engineers in the South East for Real Time Applications including 
GRAPHICS, COMMUNICATIONS, CONTROL / ROBOTICS, 
SIGNAL/IMAGE PROCESSING & MODELLING. 


NEW PRODUCT DEVELOPMEN 


This High Technology company is Now 
seeking to expand it's Software Team 
working on New Projects for Image 
Processing & Scientific Instrumentation Systems. You will have at 
least 4yrs software experience particularly with C and UNIX. 
Experience of Windows and Low Level Graphics also useful. 


Medical Electronics 
Surrey £22K 


Office Automation This well known designer of computer 
Berks iphiem systems seeks an experienced 
Software Engineer to be responsible for 
developing their New Projects in office communications. 3yrs plus 
software design is needed of both High and Low Level languages 
(C, Intel Asm) gained in a PC-comms environment. 
Control Systems Expanding designer of Real Time 
Surrey eteeyiem control systems seeks experienced 
software design engineers at all levels 
to Team Leader to work on their New developments. Your 2yrs plus 
experience of Real Time and Low Level software design (C and 
Intel/Motorola assemblers) combined with the capability to lead a 
Team of engineers will be most useful. 


Call James Hunt or Ron Cook NOW! 
TEL: (0425) 475480 (24hrs) FAX: (0425) 480807 


LASH) associates 


Recrultment Consultants 
3 Pipers Ash, Ringwood, Hants, BH24 1UF 


Hertfordshire 


A challenging opportunity to work in the R & D section 


will be Degree or M.Sc qualified & have at least 12 months 
experience of coding in C. A knowledge of MS-Windows is 
desirable but not essential. This position is ideal for a 


environment & use the latest software and hardware. 


skills in C, Unix, Graphics, X-Windows or Macintosh. You 
will play a key role in product development for the 
commercial market worldwide. If your experience includes 
any of the above, please call for a confidential discussion. 
Contact Teresa Maddern 


W. London/Midlands 
This expanding, successful, communications specialist have 
an exciting new MIS project & require GUI specialists 
preferably with Apple Macintosh or ORACLE experience. 
There are excellent career opportunities with a 


Contact Christine Trybus 


C Programmers 


£Neg. 


developing new technologies for this International Group. You 


programming purest who flourishes on coding challenges. You 
will, in return, receive a good salary, work ina state-of-the-art 


Contact: Paul Innes Ref: P10601 Experience of programming, device drivers & H/W interfaces. 
Contact Paul Innes Ref: PI0602 
Design in Colour 5 5 
in D 
He IBLIIK C/Unix/XWindows/RDBMS/SQL 
London/Cambs to £30K 


Leading the development of Unix based computer controlled 
Workstation/Imaging systems for the Graphics Industry, our 
client is seeking Software & Software Support Engineers with 


Ref: TM0601 


GUI Specialists/Oracle 


to £25K 


comprehensive training scheme & generous benefits package. 
Ref: CT0601 


Herts to £25k 


Developing integrated corporate office software for the 
world-wide market place. You should have at least two of the 
following: ‘C’, UNIX, TCP/IP, X-Windows, GUI, E-Mail or 
Graphics. 


Bucks/Berks borders to £23k 


Revolutionary developers of emulation technology seeking 
self-motivated software engineers for full project life-cycle 
development. If you have strong ‘C’ skills combined with some 
of: UNIX, VMS, MacOS or MS-DOS. {st class employer 
offering profit share, share options and flexitime. 


Yorks £15k - £20k 


Forefront Spatiai Information Developer is seeking innovative 
software designers with sound problem solving skills. Your 
skills should include 2 years of ‘C’/UNIX applications and 
experience of using relational database tools, any structured 
methods, graphics or Windowing. 


City to £30k + benefits 


Major financial institution is seeking bright software staff to 
develop Real-Time Market Information Systems covering 
such applications such as currency options, price modelling, 
tisk analysis and time series databases. You should have 
solid ‘C’ skills combined with some of: UNIX, VAX/VMS, 
Ethernet, C++, OS/2, Sybase, Windows, Motif or 4GL’s. 
Benefits include subsidised mortgage! 


MANY OTHER OPPORTUNITIES THROUGHOUT UK AND EUROPE 


/\ 


ACUMEN 


071 371-8496 
ACUMEN SEARCH & SELECTION INTERNATIONAL 
EBC House, 1a Ranelagh Gardens, 
London SW63PA Fax: 071 371-8502 
Out of hours telephone: 081 780-0637 


Systems Programmers 


Oxfordshire to £18K 


An opening now exists for an enthusiastic programmer to 
develop complete Turn Key Solutions of the future. A good 
degree in Computer Science and some experience in each of 
the following categories is required: 

Languages: C, Pascal, Assembler 

Operating Systems: DOS, UNIX, XENIX 

Tools: WP, Databases (particularly Paradox), Spreadsheets 
Communications: ARCNET, NETBIOS, NOVEL, TCP /IP 


We have urgent requirements for two successful reputable 
service organisations to provide consultancy & develop 
financial & commercial applications using C, UNIX & 
XWINDOWS & INGRES/ORACLE. The successful candidates 
will be educated to degree level with at least 2 years experience 
with C & UNIX & either X WINDOWS or RDBMS/SQL. 
Contact Christine Trybus Ref: CTO602 


For more information call 0442 231691 days or 0442 69740 
eves/wkends. Alternatively send your CV to the address 
below or fax details to 0442 230063 


Executive Recruitment Services 
Hempstead House, Selden Hill, 
Hemel Hempstead, Herts. HP2 4LT 


ADVERTISERS INDEX 


ADVERTISER PRODUCT/SERVICE CIRCLE PAGE | ADVERTISER 

Al International OOP Languages & Environments 500 87 Microsoft Press 
Applied Logic Object Oriented Programming 498 84 Nantucket 

Atom Style Hardware 495 82 Next 

Biton Clipper Software 506 93 Nu-Mega 

Bits & Pieces Peripheral/ExpansionProducts 512 91 PC Bookshop 

Bits Per Second | Graphics for Visual Basic 459 35 Polyhedron 

Bits Per Second Il Graphics for Clipper 460 37 Positive 

Blink Clipper Fast Linker 451 26 QA 

BL Security Software Protection 504 92 QBs! 

Borland Borland C++ 429 7 QBSII 

Brent Communications MAX copy Protection 447 21 QBS III 

CEBRA Communications Multi VGA Adapters 471 49 Readmar! 

Clearsoft Software Security 463 4 Readmar Il 

CTL Copy Protection Hardware 499 84 Real Techniques & Methods 
Cocking & Drury Smalitalk V 476 53 Ridgeway 

DES Software Protection 492 79 | Roundhill 

Digital DR DOS 501 88 Salford S/W Marketing 
Evergreen Case Tools 490 76 —_| Softlok Intemational 
Expert Systems Prolog 2 for Windows 3.0 511 91 Software Con, Co. 1 
FACTS Direct FAX Service 502 90 Software Con, Co. II 
G-Force Graphical Interface for Clipper 464 42 Software Generation 
Glockenspiel Class Constructors 509 OBC | Software Paradise 
GWwi Software Design Tools 484 67 Software Security 
Grey Matter Programming Tools 427 3 Solution Systems 
GUI-Euro Ltd GUI Software 466 44 System C 

Guildsoft PC Automation Software 461 37 System Science! 
HS Systems 8051. C Compiler 503 91 System Science Il 
Inst.Analysts/Programmers —_ Institute 470 49 System Star! 
Instruction Set Training 4a4 18 System Star Il 
Instrumatic Oregon C++ 478 59 System Star Ill 
Intasoft Software Management System 493 79 System Star lV 

ITEL Applications Generator 497 83 System Star V 

JPI C++ Compilers 474 51 Thripplewoods 
Lahey Fortran Compiler 472 51 Unisystems Software 
LPA AI/KB/OOPS Software 452 29 USA Software 
Magnifeye Software Protection Device 489 5 User Friendly 
Microft Security Software 507 94 Xoren 


PRODUCT/SERVICE CIRCLE PAGE 
Book Publishers 481 65 
Clipper 449/450 20/25 
Workstation 433 16 
Debugging Tools 430 8 
Book Specialists 448 21 
FORTRAN Compiler 483 67 
Editor 462 38 
C Training 426 IFC 
Clipper Function Library 457 32 
Programmers Editor 482 66 
Clipper Add-Ons 488 73 
Configuration Management 446 20 
Tools 505 92 
CASE for Windows 478 5 
Computer Manuals/Binders 453 29 
Development Tools 480 62 
FORTRAN for DOS & UNIX 485 67 
Piracy Protection 508 97 
Development Tools 458 35 
Development Tools 477 57 
Version Control 475, 52 
Business Software 479 60/61 
Security Products 445 19 
Programming Editors 491 7 
Application Generator 487 70 
Maths Software 513 59 
Development Tools 486 69 
DBMS 432 13 
Software Tools 454 29 
Chart Drawing Software 456 31 
DOS Extender 467 45 
Interface Management System 469 49 
Sanyo Special Offer 510 85 
Systems Management Tools 431 12 
Programming Tools 468 47 
Software Copy Protection 455 31 
File Transfer Software 465 43 


STOB - Not fairies’ footfalls 


‘Backing up? Why, backing up is for punters!’ (Traditional. 


Finish typing in ammended comment and 
hit Alt-V for Verity’s Compile, Link, Save to 
disk and Run (it only took me about eight 
hours in macro programming to set this up, 
which quite justifies the two minutes it must 
save me each week). The server is right 
behind me, so I can hear the familiar rhythm 
of the 300 MB hard disk as the compiler 
shifts up through the gears, you know, I bet 
I could identify most of the software on our 
network blindfolded, I’m so familiar with 
the different sounds... 


Hold up. Put smallthought on Pause a sec. 
It’s not making the usual noise. Instead of 
fairies’ muffled footfalls on drum, we have 
distant scream like inexpertly wielded 
bluntish drill bit skidding on car wing. 
Listen. There it is again. 


Now, Verity, don’t panic. Ignore cold feel- 
ing on nape of neck, suppress urge to hiss 
‘If you have lost this file I will biteyou’ into 
server's A: drive. Be calm. Be rational. Ctrl- 
C. There; that’s broken out of the macro. 
Attagirl. File. Save As. C: \PLEASE.CPP. 
And, with careful finger, press ENTER key, 
so that, in a second, in a second, ‘QEMM 
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has detected an attempt to execute an il- 
legal instruction in the program you were 
running. Press E to end the program, or R 
to reboot the computer.’ Or how about ‘B’ 
to tell QEMM to Bog off and mind its own 
bloody business. 


Well, that’s three hours work down the 
drain, ha-ha (no, that was a light laugh, no, 
not at all like that woman in Casualty 
whose head exploded), so I suppose we 
may as well find out what’s up with server. 
DIR C:\, two trillion things flick by at the 
speed they do ona 486, fine. DIR D:\, same 
thing. DIR E:\, someone switches on the 
Black and Decker again, we have a General 
Failure Reading Drive E:\, guess which 
drive someone has entrusted with all her 
recent work, General Failure Verity’s Tem- 
per; Abort, Retry, Ignore, Scream. 


Look at backup log, to discover who made 
most recent weekly copy of server. Dave. 
Uh-huh. You remember Dave - the man 
with two talents: he can solder an IC chip 
holder onto a bit of vero while squinting 
through the smoke of a Silk Cut Menthol, 
and he cheats on his wife every Thursday 


night - she believes it has taken a year to 
repaint the TA hut. Dave’s just the chap to 
be entrusted with my life’s, ok week’s work. 


Oh, Hi Dave, you couldn't just lend me the 
tape of the backup that you made last Fri- 
day. What’s that? You didn’t do a full 
backup? So what sort of backup did you 
make, you old cockchafer? You made a 
partial backup of C: and D: did you, you old 
cockchafer. Well you know what, you old 
cockchafer, you're not fit to back up a 1969 
Mini on a disused airstrip, never mind a 
computer, you old... 


And so, as we leave Verity swearing at ber 
colleague, Betty the Backup Bunnie says: 
‘Remember, Readers, a few minutes spent 
backing up your work is more than just a 
few minutes lost drinking time.’ 


This edition of Stob was sponsored by the 
HM Government Department for Getting 
People to do Sensible Things for Their Own 
Good. For a free leaflet, please write to the 
Abandoned Fridge, Unreported Gas Leak 
Road, East Condom, Cholesterolshire. 
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VANTED 


Develop high performance networking products: 


e Software Engineers 


e Hardware Engineers 


Madge Networks, the world leader in token ring networks for PCs, 
needs more excellent engineers. Our engineers: 


e Develop World Class Products 


e@ Have fun in the process 


e Forma highly-motivated team 


@ Make a major contribution to a company 
doubling in size each year. 


Personal excellence is an absolute requirement. All applicants will have at 
least one of: 
e A First Class Honours Degree 


@ 3A grades in numerate A-level subjects 
e@ A world class flair for developing computer systems 


Previous experience of networking is not required. Starting salaries for 
engineers range up to £30K, depending on experience. 


To apply, please send a full CV to Fiona Woods at: 


Madge Networks Ltd 
100 Lodge Lane 
Chalfont St. Giles 
Bucks HP8 4AH 


Who put C++ to Work? 


glockenspiel 


lass constructors 


Glockenspiel C++ 


Glockenspiel C++ leads the 
field in object-oriented 
programming. It’s the most 
effective and efficient 
implementation around. 

It conforms exactly to the 
AT&T C++ specification — 
and they don’t come any 
closer than that! Portable 
too: it’s on more platforms 
than any other C++ 
implementation. 


Glockenspiel 
CommonView® 


Glockenspiel CommonView 
is the leading C++ class 
library for developing 
Windows, PM and 
OSF/Motif applications. 
Logical, well structured and 
easy to use, CommonView 
is 3 to 5 times more 
productive than the API. 


C++ Training & 
Consultancy 


Glockenspiel C++ training 
courses reflect our 
experience as C++ 
developers. From design to 
development, /earn from the 
best! 

Our C++ consultancy 
services match your needs 
as you commit more 
resources to C++ and 
object-oriented development. 


Further Information 


GLOCKENSPIEL, 39 Lower Dominick Street, Dublin 1, Ireland. +353 (1):733166. Fax +353 (1) 733034 
@ US: IMAGESOFT, (516) 767-2233. Fax (516) 767-9067. OASYS, (617) 862-2002. Fax (617) 863-2633 ml UK: QA TRAINING LTD., (0285) 655888. Fax (0285) 650537. 
Italy: INFERENTIA, (02) 26680568. Fax (02) 2364258. ll Sweden: LINSOFT, (01) 3124780. Fax (01) 3152429. li Germany, Switzerland, Austria; PSI, (06021) 492-0, Fax (06021) 492-112 
tm Benelux: RIINHAAVE, +31 (71) 218121. Fax +31 (71) 216118 


Glockenspiel CommonView and Glockenspiel C++ are registered trademarks of Glockenspiel Ltd. The trademarks of their respective corporations are acknowledged. 
Glockenspiel "Colour Rotation" logo by Francis Tansey 


CIRCLE NO. 509 


